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Preface 



U Apple II , encore et toujours 



Eplucher un ordinateur : quelle idee bizarre. Aujourd'hui, le monde 
de I'ordinateur individuel ne se repartit-il pas en deux categories bien 
distinctes, les producteurs d'une part (de materiels et de logiciels), les 
utilisateurs, ou plutot les consommateurs, de I'autre? Ne sommes- 
nous pas dans I'ere industrielle? 

L'informatique personnelle n'a pourtant pas - pas du tout - commen- 
ce comme cela. Au debut des annees 80, tout a commence par un 
ingenieur inventif, bricoleur, plaisantin un peu anar, qui a fabrique 
dans son garage une machine qui s'est vendue ensuite k des millions 
d'exemplaires: ce bricoleur s'appelait Steve Wozniak, et la machine 
s'est tr^s vite appelee 1' Apple // . 

Une cohorte d'etudiants, de professionnels de l'informatique sur 
gros syst^mes, d'intellectuels divers, s'est ensuite emparee de la 
machine. On a appele ces gens des hackers. lis etaient mus par la 
curiosite (je veux savoir ce que cette machine a dans le ventre), et par 
la volonte de maitriser les possibilites apportees, aux individus eux- 
memes, par leur ordinateur (je sais que cette machine peut le faire, et 
je n'arreterai que quand j'aurai reussi k le lui faire faire). lis etaient 
encourages par Wozniak et par Apple : Wozniak n'avait-il pas public, 
et mis dans le domaine public, le code originel du moniteur (la partie 
de programme installee dans la machine, et qui la dirige au plus pr6s) 
del' Apple? 

Beaucoup d'eau a coule sous les ponts depuis cette epoque : le progr^ 
technique, d'une part (il va tr^s vite en informatique), les exigences de 
la concurrence et du succfes economique d' autre part, ont profession- 

copyright Too/bo* 1990 7 



nalise rinformatique individuelle. Apple est devenu une multinatio 
nale cotee h Wall Street, I'informatique individuelle a gagne I'entre- 
prise, IBM s'est mis de la partie. 

Apple a fait enormement d'efforts, a depense beaucoup d'argent 
gagne avec I'ain^ (1' Apple // ) pour developper le cadet (le Macin- 
tosn) et le faire entrer dans I'entreprise. Beaucoup de hackers sont 
devenus des developpeurs appointes, et generalement pas sur 1' Ap- 
ple//. 

L' Apple / / lui-nneme a chang^: il s'appelle d^sornnais Apple / / GS. 
II ressemble beaucoup k son cadet, le Macintosh: par exemple, il est 
muni d'un syst^me a' exploitation (GS/OS), et d une boite h outils 
logicielle (Toolbox) qui font qu'il se programme largement comme 
un Macintosh. 

II n'y a apparemment plus de place pour les Wozniak et les hackers. 
N'en tendons-nous pas periodiquement de bonnes ames annoncer la 
mort de 1' Apple / /? 

Oui, mais voilk : la curiosite, le gout de la liberty individuelle, sont des 
choses qui ne se periment pas. Tout individu qui touche un clavier 
d' Apple / / est expose k ce virus (I'auteur de ces lignes, comme tous 
ceux qui ont contribue k ce livre, a ete contamine de cette faqon). 
D'autant qu'il existe une communaute d'utilisateurs, largement in- 
formelle mais tr^s vivace, qui se charge de partager le savoir entre 
tous ceux qui le desirent. 

D'autant aussi que si 1' Apple / / GS est un ordinateur d'aujourd'hui 
(16 bits, graphisme, son, etc.), c'est toujours un Apple / / : on peut 
done toujours, si on le veut, si on en prend le temps, le maitriser soi- 
meme, en faire ce que nous voulons, nous. II a par exemple un super- 
moniteur, qui nous permet de savoir k tout instant ce qui se passe 
dans notre machine. II a, dans sa Rom, un accessoire Visit Monitor, 
qu'on ne peut meme pas enlever en rebootant. Wozniak n'est pas 
mort, et 1' Apple / / est bien vivant. 

Ceux qui ont ecrit cet ouvrage ne sont pas des developpeurs profes- 
sionnels sur / /Gs. Ce sont des utilisateurs, mais d'un genre special: 
ce sont des gens qui veulent maitriser leur machine, et qui y parvien- 
nent. 

Car revolution de I'informatique individuelle pose une question 
importante, une question de civilisation: si je ne suis pas le maitre de 
ma machine, queje me contente de I'utiliser, alors quelqu'un d'autre 
en est le maitre. Et ce quelqu'un, du coup, est aussi maitre de moi. 

Si en revanche, je comprends exactement ce qui se passe dans mon 
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ordinateur, je peux lui faire f aire ce que je veux, et I'utiliser comme un 
outil de ma liberty. Au lieu de dependre des bureaucraties qui ont 
produit la machine et ses logiciels, et de faire exactement ce qu'elles 
avaient prevu que nous fassions, nous montrons que I'intelligence 
des individus est toujours sup^rieure k celle d'une machine, et nous 
pouvons en particulier, ce qui emerveillait toujours Wozniak, lui faire 
faire des choses auxquelles les concepteurs n'auraient jamais pens6, 
et qu'ils croyaient impossibles. 

Pour prendre un exemple un peu technique (que vous ne compren- 
drez peut-etre qu'apres avoir lu ce livre): j'ai decouvert en lisant la 
partie sur le graphisme un true auquel je n'aurais pas pense. 

Une des limites du graphisme sur Apple // GS, c'est qu'on ne 
dispose, en Super Haute Resolution, que d'une seule page graphique, 
k la difference du graphisme HGR Apple / / . Ce qui est genant pour 
les animations. Par ailleurs, pour etre compatible avecl' Apple //, 
r Apple // GS dispose d'un systeme d'echo-memoire appele shado- 
wing. Cela n'a rien k voir avec les pages graphiques. Seulement, s'est 
dit 1 auteur, supposons que ie suspende temporairement le shado- 
wing, n'aurai-je pas I'equivalent d^une pseudo-page 2? 

Toujours cette mentalite Apple // : 



Cela n'est pas prevu dans 
outils. Mais, moi, je veux 



a machine, encore moins dans sa boite k 

-, , j_ le lui faire faire: eh bien, j'y arriverai! Et 

quand j'y suis arrive, je fais savoir k tous, y compris k Apple qui n'y 
avait pas pens6, comment on peut le faire. Sur d'autres machines, 
celui qui aurait ose violer les interdits, et aurait trouv^ quelque chose 
de ce genre, I'aurait garde pour lui ou pour le vendre, cher. Sur 
r Apple / /, c'est d^j^ comme cela qu'on avait in vente la Double Haute 
Resolution. 

C'est cela I'esprit Apple / / : les raisons qui font que nous avons choisi 
un Apple // GS comme ordinateur personnel ne sont pas d'abord 
techniques (bien que le GS soit une excellente machine). Elles ne sont 



machine du patron, ce n'est pas non plus le meilleur des gagne-pains). 
C'est simplement la machine la plus polyvalente, ceffe dont nous 
pouvons faire ce que nous voulons: c'est un instrument de notre 
liberty. S'il nous arrive de critiquer Apple dans ce livre, que nul ne s'y 
trompe: c'est parce que nous aimons nos GS. 

On le voit, cet ouvraee est destine k tous ceux, quel que soit leur 
niveau de depart, du debutant k I'expert, qui veulent comprendre et 
maitnser leur ordinateur. Les debutants pourront eplucher, couche 
par couche, leur machine. Les experts apprendront forc^ment certai- 
nes informations qu'ils ne connaissent pas encore. Sur 1' Apple / / GS, 
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mais pas seulement: en mettant du Macintosh dans le GS, Apple a 
introduit le loup (les bidouilleurs sur Apple / / ) dans la bergerie du 
Mac. U Apple // GS epluche, c'est peut-etre bien aussi le commence- 
ment du Macintosh epluche. , 
— Oui, mais moi, me direz- vous, je veux seulement apprendre am en 
servir. Je ne veux pas devenir un expert, et I'etat du oit 7 de $C035 
m'indiff^re: je veux seulement pouvoir faire mon courrier sans pro- 
bl^me. 

— Je vous repondrai que c'est un desir parfaitement legitime : nioi 
aussi, je me sers du telephone sans chercher h comprendre ce qu'il y 
a dedans. Je veux juste que qa marche. On ne peut pas etre un bncoleur 
dans tous les domaines, il f aut aussi pouvoir se servir des choses telles 
qu'elles sont, betement. 

Seulement, il faut etre franc: ce qui va suivre id, vous ne le lirez pas 
ailleurs, parce que c'est ce que tout le monde cache. Ce desir, parfai- 
tement legitime, ne peut pas aujourd'hui etre vraiment satisfait -par 
aucun orcfinateur personnel, et par aucun logiciel. Tous ceux qui vous 
parlent d'ordinateur facile, oCi il n'y a rien k apprendre, qui vous 
vantent I'ordinateur comme la solution sans effort h tous vos proble- 
mes -eh bien ceux-m vous mentent, tout simplement. C'est vrai, un 
ordinateur Apple est plus facile d'acc^s que ces machines sur lesquel- 
les gal^rent ceux qui n'ont pas eu le choix: mais il va vous falloir, de 
toute fagon, beaucoup d'efforts pour pouvoir vous en servir vrai- 
ment. 

La premiere experience de I'utilisateur naif (celui qui croit les publi- 
cit^) d'un ordinateur personnel, c'est celle du bug, du plantage, du 
Fatal System Error, de la bombe sur I'ecran, etc. II ne faut accuser 
personne de cette fatalite: I'industrie de I'informatique personnelle 
est si jeune, et le progr^s technique y est si rapide, que c'est largement 
inevitable. II faut au moins cinq ans d'utilisation pour debuguer 
entierement une machine, un syst^me d' exploitation, ou un logiciel. 
Mais alors, ils sont perimes. 




uuiisaicui- graphique-souris. Effectivement, Apple a appris . 

k la machine. Mais la machine est bete, supremement bete - et les 

hommes qui ont congu cette machine ne sont que des hommes. 

II y a meme, dans nos ordinateurs, des pepins introduits expr^s pour 
bloquer I'utilisateur et I'empecher de faire certaines choses: il y a par 
exemple, dans la Rom de 1' Apple / / e, une destruction systematique 
de deux octets par page memoire en cas de Pomme Controle Reset. II 
y a dans 1' Applesoft en Rom, depuis 1' Apple // +, un true pour 

10 copyright Tooftox 1990 



empecher I'utilisateur de lister un programme Basic. Plus un true 
pour verifier qu'on n'a pas enleve ces trues! 

Je n'accuse pas particulierement Apple : la meme chose est vraie de 
tous les constructeurs et de tous les editeurs de logiciels. Simplement, 
cela implique que si vous voulez vraiment vous servir (simplement 
vous servir) de votre ordinateur, alors il faut pouvoir le comprendre. 
II n'est pas possible de s'en servir betement. 

Un mot encore sur la devise No Tools que vous trouverez qa. et 1^ dans 
eet ouvrage: elle n'est pas k interpreter de fagon negative, comme le 
refus pur et simple des outils de I' Apple // GS. Nuld'entre nous ne 
songe k se priver des excellentes applications orthodoxes qui existent 
sur le GS, ni de GS/OS, ni des accessoires (NDA et CDA). D'ailleurs 
la presente preface est ecrite avec le traitement de textes d'une 
excellente application GS orthodoxe, Appleworks-GS, de Claris. Et 
nous Savons tous qu'il y a au moins un outil k respecter si I'on veut 
rester compatible, a savoir le Memory Manager. La programmation 
avec la Boite k Outils est un des modes de programmation de 1' Apple 
/ / GS: elle fait de lui un petit Mae / /, et un excellent outil de travail. 

Simplement, 1^ ou nous divergeons avec certaines proclamations 
d' Apple, e'est que nous pensons que ce mode de programmation n'est 
pas le seul possible. D'une part, les utilisateurs d' Apple // sont 
capables de s'habituer k plus d'un interface utilisateur, car I'interface 
Macintosh ne peut pas tout. Essayez done de gerer les sous-sous- 
catalogues d'un disque dur avec le Finder, vous m'en direz des 
nouvelles. 

D' autre part, 1' Apple / / GS est aussi un Apple / / , et un Apple / / se 
programme sur le metal: programmer, e'est maitriser la machine. 

La programmation avec la Boite k Outils, si elle facilite en un sens le 
travail du programmeur (et rend ses applications plus facilement 
portables sur d'autres machines), intercale une couche logicielle 
aveugle entre le programmeur et I'ordinateur. Du coup, au moins 
trois strates logicielles separent I'utilisateur de sa machine: la Boite k 
outils, le Syst^me d' exploitation, et 1' application. Et sijamais, comme 
e'est souyent le cas, cette application est programmee dans un Ian- 
gage dit evolue, il faut rajouter une quatrieme couche (le compilateur 
et ses librairies). Allez done ensuite savoir d'ou vient le bug! 

II existe de tr^s bons ouvrages, en frangais et surtout en anglais (dont 
d'exeellents publies par Apple lui-meme) qui permettent de remon- 
ter de I'utilisateur vers la boite k Outils. II en est bien peu, et aucun en 
frangais, qui permettent de descendre directement de la machine vers 
I'utilisateur. Get ouvrage remplit done un vide, dont il aurait ete 
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dommage qu'il reste beant trop longtemps. 

Comment se g^re exactement le Smartport? Comment faire des 
animations directement sur I'ecran graphique? Comment utiliser au 
mieux le DOC pour le son? Si vous lisez les documentations et notes 
techniques Apple, vous aurez quelques fragments de r^ponses, mais 
vous aurez aussi sou vent I'impression que vous n'avez pas besoin de 
savoir tout ga. 

Certains, pourtant, en savent un peu plus: ils se taisent et exploitent 
le filon. D'autres ont cherche, et, comme c'est un Apple / / , ils ont 
trouve beaucoup de choses. Lecteurs, vous avez une chance assez 
rare, car il y a un point que j'ai oublie dans le portrait des hackers que 
vous avez lu ci-dessus: si un hacker aime partager ce qu'il salt, il 
n'aime g^neralement gu^re ecrire. Bravo k Toolbox d'avoir su con- 
vaincreles auteurs. 

Ce livre ne dit pas tout, loin de 1^: il a choisi I'approfondissement 
plutot que le survol. Chacun a creus6 son sillon: il a labour^ profond, 
et vous trouverez dans cet ouvrage des informations que vous ne 
trouverez nulle part ailleurs. 

Mais il reste encore des zones en friche: le port ADB (clavier, souris, 
etc..) et son microprocesseur specif ique, le port SCSI de la carte SCSI 
Apple, les ports serie. Appletalk, les Roms 03. etc.: il y a beaucoup de 
choses h comprendre et a maitriser dans le GS, beaucoup d'autres 
volumes du // GS 6pluch6 k 6crire. 

Esp^rons que celui-ci saura donner k certains de ses lecteurs le gout 
d'eplucher aussi, pour leur part, leur GS, et de maitriser eux-memes 
leur machine. Apple // for ever, la fameuse devise de Wozniak, n'a 
pas d' autre sens que ce souhait que I'ordinateur reste k jamais ce qu'il 
doit etre: non pas I'auxiliaire de Big Brother, mais un instrument - oh 
combien puissant - de la liberte des individus. 

J.Y. Bourdin 

Professeur agreg^ de philosophie. 

Ecrit dans la revue «Pom's» oCi il tient une chronique r^gili^re sur 

r Apple / / appel^e «Apple / / for ever» 

Le 5 F^vrier 1990. 
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Introduction 



Le moins que Ton puisse dire, c'est que la litterature frangaise sur 
I'Apple II GS, n'est pour I'instant gu^re etendue. Entre les clefs pour 
Apfjle IIGS de Madame Nicole Breaud-Pouliquen (prenez la deuxi^me 
edition), et le li vre sur la Toolbox de Monsieur Curcio, il n'y avait rien. 
C'est un peu ce vide que nous tentons k travers ce livre de combler. 

Nous avons volontairement delimite notre livre. Nous ne traitons pas 
de la Toolbox, pour plusieurs raisons : la premiere etant que les tools 
ne sont pas encore arrives k «maturite» et qu'ils sont sujet k modifi- 
cation de la part d' Apple. Le nouveau GS risque de les voir modifier. 

D' autre part nous voulons controler notre GS k I'octet pret, et nous ne 
voulons pas par choix, confier certaines taches k des outils, qui 
prennent enormement de temps machine, enormement de place sur 
disque, - quoique le nouveau GS a les tools en rom - et qui obligent k 
respecter des normes ^laborees par Apple, et par 1^ meme k appren- 
dre ces normes. Cependant nous comprenons fort bien que pour cer- 
taines applications professionnelles, les tools peu vent s'averer fort 
utiles. 

Ensuite le livre de Monsieur Curcio, traite fort bien du sujet, meme si 
certaines parties seraient k reactualiser. Par consequent pour la partie 
tools, voyez son livre. 

Enfin, parce que meme si le cel^bre cri «NO TC)OLS» n'est pas de 
nous, nous y adherons. 

Ce livre s'adresse k toute les personnes possedant un Apple II GS, 
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mais il est certain que dans ce livre nous ne vous dirons pas comnnent 
installer une carte dans un slot ou comment programmer en basic, 
pour cela il existe les manuels Apple qui vous sont vendus avec votre 
GS. 

S'il etait relativement facile de maitriser 1' Apple 2e et 2c, - facilite qui 
a permis a quelques pseudo-informaticiens megalomanes, parce 
qu'ils savaient modifier un octet, de se faire un nom sur 2e - il est 
beaucoup plus difficile de maitriser compl^tement le 2 GS, et il est 
d'ailleurs amusant de constater que ces pseudos-informaticiens ont 
disparu avec revolution technique qu'a represente le 2 GS. 

Si nous avons un dernier conseil k vous donner avant de lire ce livre, 
ce serait de vous munir d'un assembleur. Tous les auteurs de ce livre 
utilisentl'assembleur «Merlin 16» dechez«Roger Wagner Publishing 
Inc». 

Sachez que ce livre a necessite 4 mois de travail h 5. Nous sommes 
prets k en ecrire un second, notament sur les peripheriaues, les 
extentions, si ce livre connait dans le milieu du IIGS, un reel succ&s. 



Nous esperons simplement que vous I'apprecierez, et que vous corn- 
prendrez mieux le fonctionnement de 1 Apple IIGS. Ceci afin que ' 
IIGS ai la m^me dur^e de vie que le 2e. Cest notre seul souhait. 



Pour toutes questions, remarques, ou suggestion n'hesitez pas h nous 
joindre via notre editeur - Toolbox - 6 Rue Henri Barbusse, 95100 
Argenteuil. Nous tenterons de repondre dans la mesure de nos 
connaissances k tout votre courrier. 



Les Auteurs 
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le 65C816 



1.0. Avant propos sur les microprocesseurs 

Les microprocesseurs tels que nous les connaissons k I'heure actuelle, 
sontnes en 1972. A cette date le developpement de la technologie etait 
devenu tel qu'il fut possible de fabnquer des circuits comprenant 
plusieurs milliers de transistors. 

Le microprocesseur est compose de deux elements principaux : 

1) un processeur, c'est k dire I'element capable de traiter des informa- 
tions. 

2) un circuit integre, c'est h dire un ensemble indissociable de transis- 
tors, realisant differentes fonctions, enfermes en un meme boitier. 

Le microprocesseur realise des operations arithmetiques (+, - ,* ,/) 
ainsi que les operations logiques (ET, OU, OU EXCLUSIF). II est 
capable d'effectuer des decalages et des rotations h droite, h gauche, 
des comparaisons, des masques. 

II peut meme prendre des decisions suivant le resultat d'une opera- 
tion (si le resultat est inferieur, egal, ou superieur h la donnee 
comparee). 

1.0.1 L'organisation d'un microprocesseur. 

Un microprocesseur se compose de 3 parties principales : 
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1.0.1.1 L'unitede controle 

L'unite de controle decode les instructions envoyees par la memoire 
et elabore les signaux de commande necessaires k 1' execution d'un 
programme. 

1.0.1.2 L'unite arithmetique et logique 

L'unite arithmetique et logique se charge de I'execution des opera- 
tions arithmetiques et logiques. 

1.0.1.3 les registres 

Les registres se classent en 2 categories 

Ceux qui sont accessibles par le programmeur et ceux qui ne le sont 

pas. Nous n'etudierons que les registres accessibles par les program- 

meurs. 

Ces registres se classent eux-memes en trois sortes : 

1.0.1.3/1 les registres de donnees, 

Assurent le stockage intermediaire de donnees allant vers ou venant 
de l'unite arithmehque ou logique, ou de la memoire. 

1.0.1.3/2 les registres d'adresses 

Ce sont en fait les pointeurs qui stockent I'adresse d'une position 
memoire. 

1.0.1.3/3 le compteur ordinal et le registre d'etat du processeur. 

Le compteur ordinal suit pas h pas I'execution d'un prog;ramme. II 

ifldiqu§ au micFO|3Foce§§§ur radre§§e de la prochain§ in§tTuction 

devant etre executee. 

Le registre d'etat du processeur contient un certain nombre de bits po- 
sitionnes ^ ou 1, suivant le resultat obtenu apr^s I'execution de 
certaines instructions. 

1.0.2 Le langage du processeur. 

Le microprocesseur ne connait que le langage binaire. Le bit se 
caracterise par 2 etats ou 1 qui au niveau du processeur se materia- 
lise par deux tensions (0 et 5 V). 

8 bits forment un octet. Avec un octet on peut distinguer 2**8 etats, 
c'est h dire que Ton peut selectionner une instruction parmi 256 
positions de memoire. 
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1.1. Le microprocessexir du GS. 

1.1.1 Introduction 

Le microprocesseur de I'apple 2 Gs est le 65C816 concu par David D. 
Mensch Jr, de chez Western Design Center. C'est un successeur 16 bits 
du 65C02. II peut adresser 16 Mo de $00/ 0000 k $FF/FFFF, poss^de 
un bus d'adresse de 24 bits et porte & 16 bits tous les registres existants 
du 65C02. C'est en fait un faux 16 bits car son bus de donnas est de 
8 bits. Mais vu les faibles tennps d'acc^s memoire, cela n'est pas vrai- 
ment penalisant.Le 65C816 n'est pas le seul successeur du 65C02, il 
existe aussi le 65C802, qui est un 65C816 qui n'op^re que dans le banc 
0, mais qui a I'avantage d'etre compatible broche h broche avec le 
65C02. Ce microprocesseur est dit «hybride» car il a la particularite de 
pouvoir op^rer en 2 modes, et de passer de I'un k 1' autre : 

- en mode natif soit en 65C816 

- en mode Emulation soit en 65C02 

Contrairement au 65C02 qui fut fabique en NMOS, le 65C816 est 
fabrique en CMOS (Complementary Metal Oxide Semiconductor), et 
tire tous les avantages de cette technique. 

Le 65C816 peut etre cadence k deux vitesses k 2,8 Megahertz, ou ^ 1 
Megahertz. En fait 2,8 Megahertz est la vitesse theorique, la vitesse 
reelle du microprocesseur est de 2,5 Megahertz, soit 2.500.000 opera- 
tions arithm^tiques ou logiques par seconde, car un certain nombre 
de cycles sont utilises pour le rafraichissement de la memoire, et pour 
les operations de resynchronisation. 

Lorsque des donnees de 16 bits sont deplac^es de la memoire au 
microprocesseur ou inversement cette operation est effectuee en 2 
cycles. Pendant le ler cycle le 65C816 6crit ou lit les 8 bits de poids 
faible de la valeur. Pendant le second cycle il lit ou ecrit les 8 bits de 
poids fort de la valeur. Les 8 bits de poias faible sont toujours stockes 
a I'endroit effectif de la memoire. Les 8 bits de poids fort sont stockes 
k I'endroit effectif de la memoire plus un. 

1.1.2 les registres 

Les registres peuvent etre consid^res comme des memoires, mais k 
tr^s court terme, destines k memoriser des donnees lorsque des 
calculs sont effectu^s sur celles-ci. 

Le 65C816 contient bien entendu tous les registres que Ton trouve 
dans le 65C02 (A,X,Y,P,S) mais ils ont 6te 6tendus k 16 bits. Le 
concepteur du 65C816 lui a donn6 3 nouveaux registres par rapport 
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au 65C02. Tous ces registres y compris bien evidement les 3 nouveaux 
seront vus dans le detail ci apr^s. 



Shema des registres du 65C816 



8 bits 


8 bits 
(poids fort) 


8 bits 
(poids faible) 


Registre DBR 


Registre d'index X 


Registre d'index X 


Registre DBR 


Registre d'index Y 


Registre d'index Y 


00 


Pointeur de pile (S) 


Pointeur de pile (S) 




Accumulateur 
(B) 


Accumulateur 
(A) 


Registre PBR 


Compteur (PC) Ordinal 
(PCH) (PCD 


00 


Registre D 


Registre D 



1.1.2.1 L' accumulateur 

L'accumulateur est un registre de 16 bits, oil toutes les valeurs sont 
gardees pendant que des operations arithmetiques ou logiques sont 
ef fectuees. Les 1 6 bits du registre sont disponibles dans les 2 modes du 
65C816, aussi bien en mode emulation qu'en mode natif. L'accumu- 
lateur est souvent divise en 2 parties: 

- partie basse ou registre A (8 bits) - bits de poids faible 

- partie haute ou registre B (8 bits) - bits de poids fort 

Ces 2 registres A et B forment l'accumulateur et sont denommes C 
(A+B=C). 

En mode natif (E=0) quand le bit M du registre d'etat du processeur 
est egal k 0, l'accumulateur est en mode 16 bits. Quand le bit M du 
registre d'etat du processeur est egal k 1, l'accumulateur fonctionne 
en mode 8 bits utilisant uniquement la partie A de l'accumulateur. 
Dans ce dernier cas la partie B peut servir de memoire temporaire, 
notamment avec I'instruction XBA. 
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1.1.2.2 Les registres d'index XetY. 

Le 65C81 6 a deux registres d'index, X et Y, c'est k dire que leur contenu 
de ces deux registres d'index sont susceptibles de s'ajouter k une 
adresse m6moire. (Voir la partie sur I'adressage index^) 
Ces deux registres peuvent dtre en mode 8 bits ou en mode 16 bits. Si 
le bit X du registre d'etat du processeur est h 1, les deux registres 
seront en mode 8 bits; si le bit X du registre d'etat du processeur est 
icS^nf ^"^ registres seront en mode 16 bits. En mode emulation 
6i>e02, ces deux registres sont toujours en 8 bits, contrairement h 
I'accumulateur. 

1.1.2.3 Le registre direct ou Registre D 

C'est un nouveau registre par rapport au 65C02. Ce registre est en fait 
une extension de la page z4ro du 65C02. Le registre D permet que cette 
page z^ro de 256 octets (dans le 2e / 2c de $00/0000 S OOFF) puisse se 
trouvern importe oCi dans le banc z^rode $00/ 0000^ $00 /FFFF Cette 
page z6ro relogeable est appell^ la page directe. 

1.1.2.4 Le registre banc de donnees (Data bank register) 

C'est un registre 8 bits. II contient en mode natif les bits de poids les 
plus forts -I)its de 16 ^ 24 - de I'adresse d'une donn^ sp^cifi^ par le 
registre d index X ou Y. En mode Emulation les 8 bits^e ce registre 
sont mis a et ne peuvent etre modifies. 

1.1.2.5 Le registre PBR (program bank register). 

Zf\Y^J^^^^^ ^^ ^.^^}^' contenant les bits de poids les plus fort - bits 
il adresse de I'instruction suivante h ex^cuter. Ces 8 bits sont 
accol^s aux 16 bits du compteur ordinal pour former une adresse sur 
Z4 bits. 

1.1.2.6 Le registre S ou le pointeur de pile. 

Tous les microprocesseurs g^rent une pile c'est h dire une zone de 
HJiSP/res cons^cutives ob^issant h la r^gle LIFO (last in first out) ou 
Uhl^ (dernier entr^, premier sorti). La pile est n^cessaire pour contrd- 
ier les sous-programmes ainsi que les interruptions. La pile est un 
ensemble de registres ou bloc m^moire, allou^ k un empilement de 
donnees. EUe se caract^rise par sa structure chronologique, c'est k dire 
que le premier ^l^ment introduit dans la pile est plac$ au bas de celle- 
a, le suivant est plac^ au dessus, et ainsi de suite. Cette pile peut §tre 
|tendue jusqu k 64K et peut se situer n'importe oil dans le 6anc 0. 
1 our g^rer cette pile, il est n^essaire d'avoir un pointeur de pile qui 
permet de savoir oCi se trouve le sommet de la pile en memoire Ce 
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registre de 16 bits contient done I'adresse du sommet de la pile. 
II est automatiquement decremente d'une unite apr^s chaque trans- 
fert d'un mot dans la pile. II est automatiquement incremente d'une 
unite apr^s chaque lecture d'un mot dans la pile. 
Enfin le pointeur de pile joue un role particulier lors des demandes 
d'interruptions et des appels de sous-programmes. (Voir les instruc- 
tions). 

1.1.2.7 Le registre PC (program counter) ou registre compteur ordinal. 

Ce registre de 16 bits indique toujours I'emplacement de la prochaine 
instruction devant etre executee. Dej^ avec le 65C02 ce registre etait de 
16 bits. Le 65C02 n'etait capable d'adresser que 64 kilos, cela consti- 
tuait une limite, en dehors bien entendu de la technique dit du «bank 
switching*. Le 65C816 est capable d'adresser jusqu'^ 16 Mo de 
memoire en utilisant 24 bits pour I'adressage (Ajout de 8 bits par le 
PBR). Certaines instructions agissent directement sur le PC, il s'agit 
de toutes les instructions de branchement et de saut. Lors de I'initia- 
lisation, le compteur ordinal est charge avec I'adresse de depart du 
programme. 

1.1.2.8 Le registre d'etat du microprocesseur ou registre P 

Le registre d'etat du microprocesseur est un registre de 8 bits. 
Voyons maintenant bit par bit le registre P : 

bit ou C — > (carry generated) c'est le bit de report ou de retenu. Ce 
bit a un role double. II indique si une operation de soustraction ou 
d'addition a engendre une retenue, et sert de neuvi^me bit dans les 
operations de rotation ou de decalage dans le registre d'etat du 
processeur (instructions ASL, LSR, ROR et ROL) 

ou E — > (emulation mode) si ce bit est ^ 1 le 65C816 fonctionne- 
ra en mode emulation (65C02). Les instructions sur la pile et les ope- 
rations arithmetiques seront effectuees en 8 bits. Les autres opera- 
tions restent effectu^s en 16 bits. Les registres X et Y seront en mode 
8 bits.Par contre si ce bit est ^ le 65C816 est en mode natif, toutes les 
operations sous ce mode sont des operations en 16 bits. 

bit 1 ou Z — > (zero result) ou bit zero : Ce bit sera h zero si la derni^re 
operation n'a pas engendree un resultat nul. 

bit 2 ou I — > (interrupts flag) : si ce bit est k 1 les interruptions 
masquables seront inhioees (IRQ) 

bit 3 ou D — > (decimal mode) : sert k determiner le mode de calcul 
: si binaire ou 1 si DCB (decimal code binaire). 
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bit 4 ou X — > (index register size) : si ce bit est k les registres d'index 
X et Y sont des registres en 16 bits. En mode emulation (6502) ce bit est 
toujours ^ 1, et les registres X et Y fonctionnent en 8 bits. 

ou B — > (interrupt source flag) : En mode emulation 65C02, ce 
bit est h l,lorque la derni^re instruction executee etait BRK. 

bit 5 ou M — > (memory and accumulator flag) : Ce bit sert h determi- 
ner la longueur de I'accumulateur. Si ce bit est k 1 1'accumulateur est 
en mode 8 bits, si ce bit est k I'accumulateur est en mode 16 bits. 

bit 6 ou V — > (accumator oVerflov) : Ce bit indique si au cours d'une 
soustraction ou d'une addition le sigjie du resultat a change k cause du 
depassement du resultat dans le bit de signe. 

Bit 7 ou N — > (negative result) : Ce bit determine le signe du dernier 
resultat. Si ce bit est k 1, le resultat est negatif, si ce bit est ^ le resultat 
est positif. 

1.1.3 Les Instructions du 65C816 

Les instructions du microprocesseur ont et6 definis une fois pour 
toute par le fabricant du microprocesseur, et ne peuvent etre modi- 
fiees par I'utilisateur qui ne peut les exploiter que pour 6crire un 
programme. Le 65C816 poss&de 256 instructions. Ce sont ces instruc- 
tions par ordre alphab^tique que nous allons maintenant detailler. 

L4gende : . = bit non modifie 

/ = bit modifie 

= bit mis k zero 

1 = bit mis k un 
Ace = Accumulateur 

X = Registre d'index X 

Y = Registre d'index Y 

Mem = Memoire 

NVMXDIZetC sont les bits du registre d'etat du processeur. 
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ADC 

(ADd memory to accumulator with Carry) 

La fonction ADC additionne le contenu de la m^moire sp^cifite par 
I'op^rande k I'accumulateur avec le bit de report. L' operation peut 
§tre effectu^e en mode binaire ou decimal. Le r^sultat de cette opera- 
tion est mis dans I'accumulateur. 

Lors d'une addition si vous ne voulezpas que le bit de report influe 
sur le resultat, vous devez mettre ce bit de report k zero en utilisant 
avant instruction AIXl instruction CLC. 



Fonction : A < — A + M + C 

Modification des registres : 



r 



R^jstred'ltat 
du ptocesseur 

Registre 



N 
/ 

Ace 
/ 



V 
/ 



M 



Y Mem 



D 



Z 

/ 



c 

/ 



Modes d'adressage 


Syntaxe 


Code 


Octet 


Cycle 


Absolu 


ADCaddr 


6D 


3 


4 *(1,4) 


Absolu long 


ADC long 


6F 


4 


5 *(1,4) 


Absolu long index^ par X 


ADClong,X 


7F 


4 


5*(1,4) 


Absolu index^ par X 


ADCaddr,X 


7D 


3 


4*(U,4) 


Absolu ind^x^ par Y 


ADCaddr,Y 


79 


3 


4*(1A4) 


Direct 


ADC dp 


65 


2 


3*(1A4) 


Direct indirect 


ADC (dp) 


72 


2 


5»(1,2,4) 


Direct indirect ind§x6 par Y 


ADC(dp),Y 


71 


2 


5*(1,2,3,4) 


Direct indirect long 


ADC <dp> 


67 


2 


6*(1A4) 


Direct indirect long ind6x6 par Y 


ADC<dp>,Y 


77 


2 


6 •(1,2,4) 


Direct ind^x6 indirect 


ADC (dp),X 


61 


2 


6*(1,2,4) 


Direct index6 par X 


ADCdp,X 


75 


2 


4*(1,2,4) 


Immediat en emulation 65C02 (M=l) 


ADC #const 


69 


2 


2*(1,4) 


Immediat en mode natif 65816 (M=0) 


ADC#const 


69 


3 


3 ^(1,4) 


Pile relative 


ADCsr^ 


63 


2 


4 '(1,4) 


Pile relative indirecte indexee 


ADC (sr3),Y 


73 


2 


7 •(1,4) 



pour le calcul du nombre de cycles : 

(1) = ajouter 1 au nombre de cycles si M=0 

(2) = ajouter 1 au nombre de cycles si V octet de poids faible du registre D 
(direct page register) est different de zero. 
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(3) = ajouter 1 au nombre de cycles si I'addition du registre d'index fait 
changer de page memoire. 

(4)= ajouter lau nombre de cycles si kbit D (Decimal flag) du registre d'etat 
du processeur est ci let si le 65C816 est en mode emulation (6502). 



AND 



(AND accumulator with memory) 

Cette instruction effectue un ET logique entre le contenu de la me- 
moire et I'accumulateur. Cette operation est effectu^ bit k bit entre 
I'accumulateur et les bits correspondants en memoire. Le r^sultat est 
stocks dans I'accumulateur. 

L'op^ration ET logique, suit la table de v6rite suivante : 

Deuxidme ojj^rande 

Premiere op^rande 








1 











1 





1 



Fonction : A < — A '^ M 

Modification des registres : 



Registre d'etat N V M X D I 

du processeur /..... 

Registre Ace X Y Mem 

/ . . . 



Z 

/ 
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Modes d'adiessage 


Syntaxe 


Code 


Octet Cycle 


Immediat en Emulation 65C02 (M=l) 


AND#Const 


29 


2 


2*(1) 


Immediat en mode natif 65816 (M=0) 


AND #const 


29 


3 


3*(1) 


Absolu 


ANDaddr 


2D 


3 


4*(1) 


Absolu long 


AND long 


2F 


4 


5*0) 


Absolu indexe par X 


ANDaddr,X 


3D 


3 


4 *(13) 


Absolu indexe par Y 


ANDaddr,Y 


39 


3 


4 *(13) 


Absolu long indexe par X 


ANDlong,X 


3F 


4 


5*(1) 


Direct 


AND dp 


25 


2 


3 *(U) 


Direct indirect 


AND (dp) 


32 


2 


5 *(1,2) 


Direct indirect indexe par Y 


AND(dp),Y 


31 


2 


5*(1,2,3) 


Direct indirect long 


AND <dp> 


27 


2 


6*(1,2) 


Direct indexe indirect 


AND(dp,X) 


21 


2 


6 *(1,2) 


Direct indirect long indexe par Y 


AND<dp>,Y 


37 


2 


6 *(1,2) 


Direct indexe par X 


ANDdp,X 


35 


2 


4 *(1,2) 


Pile relative 


ANDsr,S 


23 


2 


4*(1) 


Pile relative indirecte indexee 


AND(sr,S),Y 


33 


2 


7*(1) 



pour le calcul du nombre de cycles : 

(1) = ajouter 1 au nombre de cycles si M=0. 

(2) = ajouter 1 au nombre de cycles si V octet de poids faible du registre D 
(direct page register) est different de zero. 

(3) = ajouter 1 au nombre de cycles si V addition du registre d'index fait 
changer de page memoire. 



I 



ASL 

(Arithmetic Shift Left) 
Fonction : 



f\f\f\f\ f\f\p\ 


10 10 10 10 


- -s' PAPTPY 


^ Y v_y\.i\j\.i 
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On decale h gauche I'accumulateur ou le contenu d'une memoire. En 
mode 8 bits le bit est mis h z6ro, tandis que le bit sortant (le 7^me) k 
gauche est transfere dans la retenue. En mode 16 bits le bit est mis 
k 2kxo, tandis que le 15 ^me bit est transfere dans la retenue. 
Cette operation correspond en fait k une multiplication par 2. 



Modification des registres : 





Registre d'etat 
du processeur 


N 
/ 


V M 


X 


D 


I Z 

/ 


C 

/ 


Registre 


Ace 
/ 


X Y 


Mem 

/ 














Modes d'adressage 




Syntaxe 




Code 


Octet 


Cycle 


Accumulateur 

Absolu 

Absolu indexe par X 

Direct 

Direct indexe par X 




ASLA 
ASL addr 
ASLaddr,X 
ASL dp 
ASLdp,X 




OA 
OE 
IE 
06 
16 


1 
3 
2 
2 
2 


2 

6*0) 

7*(1) 

5 *(1,2) 

6 *(1,2) 



powr \e calcul du nombre de cycles 

(1) = ajouter 2 au nombre de cycles si M=0. 

(2) = ajouter 1 au nombre de cycles si I' octet de poids faible du registre D 
(direct page register) est different de zero. 

BCC 

(Branch if Carry Clear) 

Le bit C (retenue ou carry) du registre d'etat du processeur est teste. 
Si le bit C est k z^ro dans ce cas un branchement relatif au registre PC 
(program counter) est alors execute. Dans le cas contraire cest I'ins- 
truction suivante BCC qui est executee. Ce branchement permet 
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d'acc^der h toute instruction situee entre -128 et + 127 octets h partir 
de I'instruction sui vante BCC.BCC est utilise dans plusieurs cas : Pour 
tester un changement de r^sultat dans la carry, pour determiner si le 
resultat d'une comparaison est «plus petit que» (dans ce cas le 
branchement s'effectue) ou «plus grand que» ou «^gal ^» (dans ces 
deux demiers cas le branchement ne s'effectue pas). 

Fontion : Si C=0 alors PC <— PC+N 

Modification des registres : 



Registre d'etat N V M X D 

du processcur 

Registre 



N 


V 


M 


X 


• 


Ace 


X 


Y 


Mem 



Modes d'adressage 


Syntaxe 


Code 


Octet 


Cycle 


Relatif 


BCCadr 


90 


2 


2*(1,2) 



pour le calcul du nombre de cycles : 

(1) = ajouter 1 au nombre de cycles si le branchement est effectui. 

(2) = ajouter 1 au nombre de cycles si le branchement conduit d. changer de 
page m^moire en mode emulation (65C02I E=l). 



BCS 

(Branch if Carry Set) 

Le bit C (retenue ou carry) du registre d'etat du processeur est test^. 
Si C est i 1 dans ce cas un oranchement relatif au registre PC (program 
counter) est alors ex^cut^. Dans le cas contraire c'est I'instruction 
suivante BCS qui est ex^cut^. Ce branchement permet d'acc^der k 
toute instruction situ^ entre -128 et + 127 octets k partir de I'instruc- 
tion suivante BCS. BCC est utilise dans plusieurs cas : Pour tester un 
changement de resultat dans la carry, pour determiner si le resultat 
d'une comparaison est «plus grand que» ou «6gal ^» dans ce cas le 
branchement est effectue, ou oien «plus petit que» dans ce cas le 
branchement n'est pas effectu^. 
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Fonction : Si C=l alors PC <— PC + N 

Modification des registres : 



Registre d'etat 
du processeur 

Registre 



N 


V 


M 


Ace 


X 


Y 



X 



Y Mem 



D 



Modes d'adressage 



Relatif 



Syntaxe 



Code Octet Cycle 



BCSadr 



BO 



2*(7^) 



pour le calcul du nombre de cycles : 

(1) = ajouter 1 au nombre de cycles si le branchement est effectue. 

(2) = ajouter 1 au nombre de cycles si le branchement conduit d. changer de 
page memoire en mode emulation (65C02/ E=l). 



BEQ 

(Branch if EQual) 

Le bit Z (zero flag) du registre d'6tat du processeur est test^. S'il est k 

1 un branchement relatif au registre PC (program counter) est alors 

effectue. Sinon c'est instruction suivante qui est execut^e. 

Ce branchement permet d'acceder h toute instruction situ^e entre 

-128 et + 127 octets h partir de I'instruction suivante BEQ. 

BEQ est surtout utilise pour determiner si le r^sultat d'une comparai- 

son est z^ro (les deux valeurs comparees sont ^gales). 
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Fonction : Si Z=l alors PC <— PC + N 

Modification des registres : 



Registre d'etat 
du proccsseur 

Registre 



N 



V 



Ace X 



M 



Y Mem 



D 



C 



Modes d'adressage 



Syntaxe 



Code 



Octet 



Cycle 



latir 



118 ti f8 



'm\ 



pour le calcul du notnbre de cycles : 

(1) = ajouter 1 au nombre de cycles si le branchement est effectue. 

(2) = ajouter 1 au nombre de cycles si le branchement conduit d. changer de 
page memoire en mode emulation (65C02/ E=l) 



BIT 



(compare accumulator BITs with contents of memory) 



Cette instruction effectue un ET logique entre I'accumulateur et le 
contenu de la memoire specifiee par I'operande. Cette operation n'af- 
fecte pas I'accumulateur. Le resultat de cette operation sera soit nul 
soit non nul, le bit Z (Zero flag) du registre d'etat du processeur sera 
done positionne suivant ce resultat. 

En mode 16 bits (65C816) les bits 14 et 15 sont recopies dans respec- 
ti vement V (overflow flag) et N (sign flag). En mode obits (Emulation) 

G§ §ont 1§§ bit! 6 §t 7 qui §ont F§eopig§ Fg§pgeti¥§ffl§nt dan§ V §t N. 

Aucune des op^randes n'est affectee par cette operation. Le registre 

d'etat lui par contre est affect^. 

En mode d'adressage immediat les bits N et V ne sont pas affectes. 
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Fonction : A < — A '^ M 

Modification des registres : 



Registrc d'etat N 
du processeur / 

Registre Ace 


V 

/ 

X 


M X 
Y Mem 


D 


1 Z 

/ 


^,,,,s,.,,.,,. 




Modes d'adressage 




Syntaxe 


Code 


Octet 


Cycle 


Immediat Emulation 65C02 (M= 

Immediat NaHf 65816 (M=0) 

Absolu 

Absolu indexe par X 

Direct 

Direct indexe par X 


=1) 


BIT #const 
BIT #const 
BITaddr 
BITaddr,X 
BIT dp 
BITdp,X 


89 
89 
2C 
3C 
24 
34 


2 
3 
3 
3 
2 
2 


2 
3 

4»(1) 
4 *(1^) 

3 *(1,2) 

4 *(1,2) 



pour le calcul du nombre de cycles : 

(1) = ajouter 1 au nombre de cycles si M=0 



(2) = ajouter 1 au nombre de cycles si V octet de voids faible du registre D 
(direct page register) est different de zero. 

(3) = ajouter 1 au nombre de cycles si I'addition du registre d'index fait 
changer de page memoire. 



BMI 



(Branch if Minus) 



Le bit N (sign flag) du registre d'etat du processeur est teste. Si le bit 
N est ^ 1 un branchement relatif au registre PC (program counter) est 
alors effectue. Sinon c'est I'instruction suivante qui est executee. Ce 
branchement permet d'acceder h. toute instruction situee entre -128 et 
+127 octets ^ partir de I'instruction suivante BMI. 
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Fonction : Si N=l, alors PC <— PC + N 

Modification des registres : 



Registre d'etat 
du processeur 

Registre 


N 
Ace 


V 

X 


M 


X D I 


Z 


■'^ol^^ 




lllllll 


I^^^K^M 


Y 


Mem 


• 


• 


• 





Modes d'adressage 


Syntaxe 


Code 


Octet 


Cycle 


Relatif 


BMIadr 


30 


2 


2*(1;2) 



pour le calcul du nombre de cycles : 

(1) = ajouter 1 au nombre de cycles si le branchement est effectue. 

(2) = ajouter 1 au nombre de cycles si le branchement conduit d changer de 
page memoire en mode emulation (65C02/ E=l) 



BNE 

(Branch if Not Equal) 

Le bit Z (zero flag) du registre d'etat du processeur est test^. Si le bit 
Z est k z^ro un branchement relatif au registre PC (program counter) 
est alors effectu6. Dans le cas contraire c'est I'instruction suivante 
BNE qui est ex6cut6e. Ce branchement permet d'acc^der h toute 
instruction situ^e entre -128 et +127 octets k partir de I'instruction 
suivante BMI. 

L'instruction BNE est utilis^e dans plusieurs cas : pour determiner si 
le r^sultat d'une comparaison n'est pas nul (les deux valeurs compa- 
r6es ne sont pas 6gales) ou pour savoir si la valeur venant d'etre 
chargee de la pile est nulle ou non. 
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Fonction : Si Z=0, alors PC <— PC + N 

Modification des registres : 



Registre d'etat N V 

duprocesseur 



Registre 



Ace 



M 



Y Mem 



D 



Modes d'adressage 



Relatif 



Syntaxe Code Octet Cycle 

BNEadr EX) 2 2*(1,2) 



pour le calcul du nombre de cycles : 

(1) = ajouter 1 au nombre de cycles si le branchement est effectue. 

(2) = ajouter 1 au nombre de cycles si le branchement conduit d chancier 
de page memoire en mode emulation (65C02/ E=l) 



BPL 

(Branch if Plus) 

Le bit N (sign flag) du registre d'etat du processeur est test^. Si le bit 
N est h zero un branchement relatif au registre PC (program counter) 
est alors effectu^. Dans le cas contraire c'est I'instruction sui vante qui 
est ex^cut^.Ce branchement permet d'acc^der k toute instruction 
situee entre -128 et +127 octets k partir de I'instruction suivante BPL. 

Fonction : Si N=0, alors PC <— PC + N 

Modification des registres : 



Registre d'etat 
du processeur 

Registre 



N 



Ace 



M 



Y Mem 



D 
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Modes d'adressage 


Syntaxe 


Code 


Octet 


Cycle 


Relatif 


BPL adr 


10 


2 


2 *(1,2) 



pour le calcul du nomhre de cycles : 

(1) = ajouter 1 au nomhre de cycles si le branchement est effectue. 

(2) = ajouter 1 au nomhre de cycles si le branchement conduit d. changer de 
page memoire en mode emulation (65C02/ E=l) 

BRA 

(BRanch Always) 

Le branchement est toujours effectue (branchement inconditionnel). 
Cette instruction est ^uivalente k JMP mais elle est limitee par Facets 
h toute instruction situee entre -128 et +127 octets h partir de I'instruc- 
tion suivante BRA. 

Fonction : PC <— PC + N 

Modification des registres : 



Registre d'etat N V M X D I 
duprocesseur . . . . . 

Registre Ace X Y Mem 


Z C 



Modes d'adressage 


Syntaxe 


Code 


Octet 


Cycle 


Relatif 


BRA adr 


80 


2 


3*(1) 



pour le calcul du nomhre de cycles : 

(1) = ajouter 1 au nomhre de cycles si le branchement conduit cl changer de 
page memoire en mode emulation (65C02/ E=l) 
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BRK 

(Software BReaK) 

Cette instruction simule une interruption, stocke le contenu du regis- 
tre d'etat et du compteur ordinal dans la pile. 
En mode 16 bits le registre connpteur ordinal est force h I'adresse 
memoire contenue dans le vecteur d'interruption en 00FFE6,00FFE7. 
En mode 8 bits le registre compteur ordinal est force k I'adresse 
memoire contenue dans le vecteur d'interruption en OOFFFE,OOFFFF. 

Fonction : en mode emulation (65C02 / E=l) 

PCL <— ($OOFFFE); PCH <— ($OOFFFF) 

en mode natif (65816 / e=0) 

PCL <— ($00FFE7); PCH <— ($00FFE6) 

Modification des registres : 



Registre d'tot N 

du processcur 

Emulation 65d)2 

Natif 65816 

Registre Ace 



V M 



X Y Mem 



D 






Modes d'adressage 



Syntaxe Code Octet Cycle 



Pile 



BRK 



00 



7*(1) 



pour le calcul du nombre de cycles : 

(1) = ajouter 1 au nombre de cycles si le 65C816 est en mode natif (E=0) 
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BRL 

(BRanch always Long) 

Branchement inconditionnel long. Cette instruction est similaire k 
BRA ou k JMP, mais BRL specific une adresse 16 bits avec I'instruc- 
tion. C'est une instruction k 3 bits contrairement k BRA qui n'en a que 
2. Le principal avantage de cette instruction par rapport k JMP est 
qu'elle est enti^rement relogeable. Cependant on gagne un cycle en 
executant un JMP en mode absolu. 

Fonction : PC <— PC + NN 



Modification des registres 



Registre d'etat 
du processeur 


N V 


M X D 


I 


Z C 




Registre 


Ace X 


Y Mem 








Modes d' 


adressage 


Syntaxe 


Code 


Octet 


Cycle 


Relatif Long 


BRL adr 


82 


3 


4 



BVC 

(Branch if oVerflow Clear) 

Le bit V (overflow flag ou bit de depassement de capacite) du registre 
d'etat du processeur est teste. Un branchement relatif au registre PC 
(program counter) est ef f ectu6 si le bit V est k z6ro. Ceci est vrai apr^s 
une operation sur des valeurs en coniplement k deux, s'il n'y avait pas 
de depassement (Resultat valide). Pour mettre ce bit k zero, vous 
pouvez utiliser instruction CLV. 

Ce branchement permet d'acc^der k toute instruction situ^ entre 
-128 et +127 octets k partir de instruction suivante BVC. 
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Fonction : Si V = 0, alors PC <— PC + N 

Modification des regisfa-es : 




Modes d'adressage 



Syntaxe 



Code Octet 



Relatif 



BVC 



50 



Cycle 



2»(1,2) 



pour le calcul du nombre de cycles : 

(1) = ajouter 1 au nombre de cycles si le branchement est effectue. 

(2) = ajouter 1 au nombre de cycles si le branchement conduit cl chancer de 
page memoire en mode emulation (65C02/ E=l) 

BVS 

(Branch if oVerflow Set) 

Un branchement relatif au regisfa-e PC (program counter) est effectu^ 
lorsaue le bit V (overflow flag ou bit de depassement de capacity) est 
IX V est a 1 lorsqu'apr^s une operation sur des valeurs en 
complement h deux il y avait un depassement (Resultat invalid^). Ce 
branchement permet d'acc^er h toute instiuction situee entre -128 et 
+127 octets h partir de I'insti-uction suivante BVS. 



copyright Tooftox 1990 35 



Fonction : si V = 1, alors PC <— PC + N 

Modification des registres : 



Rcgistre d'etat 












Z 


C 


N 


V 


M 
Y 


X 
Mem 


D I 


du prcxTCSseur 


Ace 


X 







Modes d'adressage 


Syntaxe 


Code 


Octet 


Cycle 


Relatif 


BVSadr 


70 


2 


2 *(1,2) 



pour le calcul du nomhre de cycles : 

(1) = ajouter 1 au nomhre de cycles si le branchement est effectue. 

(2) = ajouter 1 au nomhre de cycles si le hranchement conduit ^ changer de 
page memoire en mode emulation (65C02/ E=l) 

CLC 

(CLear Carry flag) 

Le bit C (carry ou bit de retenu) est mis k zero. Cette instruction est 
principalenaent utilisee avant une addition (ADC) afin que le resultat 
de cette addition ne soit pas affectee par le bit de retenu. 
Lorsque I'instruction CLC est utilisee juste avant BCC (branch on 
carry clear), cela a pour but de transformer cette instruction BCC en 
BRA (Branch always)Enfin CLC est aussi utilise avec I'instruction 
XCE, afin de remettre le microprocesseur en mode natif . 
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Fonction : C < — 

Modification des registres : 



Registre d'etat 


N 
Ace 


V 
X 


M 
Y 


X 
Mem 


D 


I 


Z 


c 




Registre 


" 


:■:;.:." * 






mmmmmm 









Modes d'adiessage 



Implicite 



Svntaxe Code Octet Cvcle 



CLC 



18 



CLD 

(CLear Decimal mode flag) 

Le bit D (Decimal mode flag ou bit decimal) du registre d'etat du 
processeur est mis k zero, afln de passer du mode decimal en mode 
binaire, pour que les instructions ADC et SBC puissent s'executer 
parfaitement. 

Fonction : D < — 



Modification des registres : 



Registre d'etat N V 
du prcxresseur 

Registre Ace X 


M X D I 


Y Mem 


z c 




— 1 


Modes d'adressage 


Syntaxe Code 


Octet 


Cycle 


Implicite 


CLD D8 


1 


2 
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CLI 

(CLear Interrupt disable flag) 

Le bit I (interrupt flag) du registre d'etat du processeur est mis h z^ro, 
ce qui a pour effet de remettre en service les interruptions. Lorsque le 
bit I est a 1 les interruptions hardwares sont ignorees. 

Fonction : I < — 

Modification des registres : 



Registre d'etat 
du processeur 

Registre 



N 



Ace 



M 


X 


D 


I 



z 


c 


Y 


Mem 











Modes d'adressage 



Syntaxe 



Code Octet Cycle 



Implicite 



CLI 



58 



CLV 

(Clear oVerflow flag) 

Le bit V (overflow flag ou bit de depassement de capacite) du registre 
d'etat du microprocesseur est mis k zero. 

Fonction : V < — 

Modification des registres : 



Registre d'etat 
du processeur 

Registre 



N 



V 




Ace X 



M 



Y Mem 



D 
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Modes d'adressage Syntaxe Code Octet Cycle 



Implicite CLV B8 1 



CMP 

(CoMPare accumulator with memory) 

L'instruction CMP effectue une soustraction virtuelle Accumulateur 
- memoire. Cependant le resultat n'est pas mis dans I'accumulateur 
qui reste inchang6. Cette soustraction correspond en fait k une com- 
paraison puisque le resultat sera soit nul, soit positif ou negatif , et par 
I^ meme determinera qu'elle etait la valeur la plus grande. Si A est 
plus grand ou ^al ^ M le bit C est mis h 1. 
bi A = M alors Z est mis k 1. 
IL y existe 2 possibilites : 

1) L'accumulateur est en mode 8 bits : la comparaison se fait sur 8 bits 

2) L'accumulateur est en mode 16 bits (M=0) : La partie A de l'accu- 
mulateur est comparee avec I'adresse effective de la memoire, la 
partie B de l'accumulateur est comparee avec I'adresse effective de la 
memoire plus 1. 



Fonction : 


A - M ==>A > M 
A<M 
A = M 








Modification des registres : 








Registre d'etat 
du processeur 


N V M X 
/ . . . 


D I 


Z 

/ 


c 

/ 


Registre 


Ace X Y Mem 
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Modes d'adressage 


Syntaxe 


Code 


Octet Cycle 


Immediat en emulation 65C02 (M=l) 


CMP #const 


C9 


2 


2 


Immediat en mcxie natif 65816 (M=0) 


CMP #const 


C9 


3 


3 


Absolu 


CMP addr 


CD 


3 


4»(1) 


Absolu long 


CMP long 


CF 


4 


5*(1) 


Absolu indexe par X 


CMPaddr,X 


DD 


3 


4*(13) 


Absolu indexe par Y 


CMPaddr,Y 


D9 


3 


4 *(1^) 


Absolu long indexe par X 


CMPlong,X 


DF 


4 


5*(1) 


Direct 


CMP dp 


C5 


2 


3 *(1,2) 


Direct indirect 


CMP (dp) 


D2 


2 


5*(1,2) 


Direct indirect indexe par Y 


CMP(dp),Y 


Dl 


2 


5*(1,2,3) 


Direct indirect long 


CMP<dp> 


C7 


2 


6 •(1,2) 


Direct indirect long indexe par Y 


CMP<dp>,Y 


D7 


2 


6 '(1,2) 


Direct index^ indirect 


CMP(dp,X) 


CI 


2 


6*(1,2) 


Direct indexe par X 


CMPdp,X 


D5 


2 


4 '(1,2) 


Pile relative 


CMPsr,S 


C3 


2 


4*(1) 


Pile relative indirecte indexee 


CMP(sr,S),Y 


D3 


2 


7*(1) 



pour le calcul du nombre de cycles : 

(1) = ajouter 1 au nombre de cycles si M=0. 

(2) = ajouter 1 au nombre de cycles si V octet de poids faible du registre D 
(direct page register) est different de zero. 

(5) = ajouter 1 au nombre de cycles si I' addition du registre d'index fait 
changer de page. 



COP 

(CO Processor enable) 

C'est une instruction similaire h BRK (break). Tout comme BRK il 

s'agit d'une interruption logicielle mais utilisant un vecteur different. 

En mode natif - 16 Bits (E=0) : 

Le registre compteur ordinal est forc6 alors k I'adresse indiqu^e par 

le vecteur en $00/FFE4,FFE5. Les op^randes de la chaine entre $80 et 

$FF ont ete reserves par le concepteur du 65C816 (Western Design 

Center). 
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Fonction : 



en mode emulation (65C02 / e=l) 

PCL <— ($FFF4) ; PCH <— ($FFF5) ; PB <— 00 

en mode natif (65C816 / e=0) 

PCL <— ($FFE4) ; PCH <— ($FFE5) ; PB <— 00 



Modification des registres : 



Registre d'etat 
du prcKesseur 

Registre 



N 



Ace 



V 



M 



D 




Mem 



I 

/ 



Modes d'adressage 



Syntaxe Code Octet Cycle 



Pile 



COP const 



02 



7*(1) 



pour le calcul du nombre de cycles : 

(1) = ajouter 1 au nombre de cycle si le 65C816 est en mode natif (E=0) 

CPX 

(ComPare index register X with memory) 

L'instruction CPX compare le contenu du registre d'index X avec le 
contenu d'une memoire. Cette comparaison correspond en fait h une 
soustraction entre la valeur contenue dans le registre X et le contenu 
de la memoire, mais le resultat est ignore. Le bit Z est mis h 1 lorsqu'il 
y a egalite dans la comparaison. Le bit C est mis ^ 1 si X> ou = ^ M. 

II existe 2 possibilit^s : 

Le registre d'index X est en mode 8 bits : la comparaison sur fait sur 
8 bits ^ 



B 

'^., 
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Le registre d'index X est en mode 16 bits (X=0) : Les bits de poids f aible 
du registre d'index X sont compares avec I'adresse effective de la 
m^moire, les 8 bits de poids fort du registre d'index X sont compares 
avec I'adresse effective de la memoire plus 1. 



Fonction : 



X-M ==> 



X>M 
X<M 

X = M 



I 



Modification des registres : 



Registre d'etat 
du proccsseur 

Registre 



N V 
/ 

Ace X 



M 



X 



D 



Z 
/ 



C 
/ 



Y Mem 



Modes d'adressage 



Syntaxe Code Octet Cycle 



Inunediat en emulation 65C02(M=1) CPX#const EO 2 2 

Inunediat en mode natif 65816 (M=0) CPX#const EO 3 3 

Absolu CPXaddr EC 3 4»(1) 

Direct CPXdp E4 2 3*(1,2) 



pour le calcul du nombre de cycles : 

(1) = ajouter 1 au nombre de cycles si X = 0. 

(2) = ajouter 1 au nombre de cycles si I' octet de poids faible du registre D 
(direct page register) est different de zero. 

CPY 

(ComPare index register Y with memory) 

L'instruction CPY compare le contenu du registre Y avec le cdntenu 
d'une memoire. Cette comparaison correspond en fait h une soustrac- 
tion virtuelle entre la valeur contenue dans le registre Y et le contenu 
de la memoire, mais le resultat est ignore. Le bit Z est mis k 1 lorsqu'il 
y a egalite dans la comparaison. Le bit C est mis ^ 1 si Y> ou = ^ M. 
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II existe 2 possibilites : 

Le registre d'index Y est en mode 8 bits : la comparaison sur fait sur 
8 bits 

Le registre d'index Y est en mode 16 bits (X=0) : Les bits de poids f aible 
du registre d'index Y sont compares avec I'adresse effective de la 
m^moire, les 8 bits de poids fort du registre d'index Y sont compares 
avec I'adresse effective de la memoire plus 1. 



Fonction : Y - M ==> Y > M 

Y<M 
Y = M 

Modification des registres : 








Registre d'etat N V M X D 
duprocesscur / . . . . 

Registre Ace X Y Mem 


I Z 

/ 


C 

/ 






Modes d'adressage Syntaxe 


Code 


Octet 


Cycle 


Immediat en emulation 65C02 (M=l) CPY #const 
Immediat en mode naHf 65816 (M=0) CPY #const 
Absolu CPYaddr 
Direct CPY dp 


CO 
CO 

cc 

C4 


2 
3 
3 
2 


2 
3 

4*(1) 
3*(1,2) 



pour le calcul du nombre de cycles : 

(1) = ajouter 1 au nombre de cycles si X = 0. 

(2) = ajouter 1 au nombre de cycles si V octet de voids faible du registre D 
(direct page register) est different de zero. 
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DEC 

(DECrement) 



Une decrementation de 1 est effectu^e sur le contenu d'un emplace- 
ment memoire specific par I'operande ou sur I'accumulateur. Si le 
contenu original de la memoire est de #$00, le r^sultat sera alors de 
#$FF 

Fonction : M < — M - 1 ou A < — A - 1 



Modification des 


registres : 












Registre d'etat 


N V 


M 
Y 


X 

Mem 


D I 


Z 

/ 


C 


du processeur 
Registre 


/ 
Ace X 



Modes d'adressage 



Syntaxe 



Code Octet Cycle 



Absolu 

Absolu indexe par X 

Accumulateur 

Direct 

Direct indexe par X 



DEC addr 
DECaddr,X 
DEC A 
DEC dp 
DECdp,X 



CE 
DE 
3A 
C6 
D6 



3 
3 
1 
2 
2 



6*(1) 

7*(1) 

2 

5*0,2) 

6*(1,2) 



pour le calcul du nombre de cycles : 

(1) = ajouter 2 au nombre de cycles si M=0. 

(2) = ajouter 1 au nombre de cycles si V octet de poids faible du registre D 
(direct page register) est different de zero. 
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DEX 

(DEcrement index register X) 

Le registre d'index X est decremente d' 1. Si le contenu original du 
registre X est de #$00, le resultat sera alors de #$FF 

Fonction : X < — X - 1 

Modification des registres : 



Registre d'etat N V 
duprocesseur / 

Registre Ace X 

/ 


M 
Y 


X D 

Mem 


I Z C 






Modes d'adressage 




Syntaxe 


Code Octet 


Cycle 


Implicite 




DEX 


CA 1 


2 



DEY 

(DEcrement index register Y) 

Le registre d'index Y est decremente de 1. Si le contenu original du 
registre Y est de #$00, le resultat sera alors de #$FF 

Fonction : Y <— Y - 1 



Modification des registres 



Registre d'etat 
du processeur 


N 
/ 


V 


M 


X 


D I 


Z 

/ 


C 


Registre 


Ace 


X 


Y 

/ 


Mem 
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Modes d'adressage 



Syntaxe 



Code Octet Cycle 



Implicite 



DEY 



88 



r 



EOR 

(Exclusive OR accumulator with memory) 

Cette instruction effectue un OU exclusif entre le contenu de la 
m^moire et I'accumulateur. Cette operation est effectuee bit h bit entre 
I'accumulateur et les bits correspondants en memoire. Le rdsultat est 
stocks en A. 

OU exclusif, suit la table de verite suivante : 
Deuxi^me op^rande 
Premiere operande 

Fonction : A <— A EOR M 

Modification des registres : 








1 








1 


; 


1 


6 



Registre d'etat 
du processeur 

Registre 


N 
/ 

Ace 

/ 


V 
X 


M 
Y 


X 

Mem 


D I 


Z 

/ 


c 


/ 











I 
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Modes d'adressage 


Syntaxe 


Code 


Octet 


Cycle 


Immediat en emulation 65C02 (M=l) 


EOR #const 


49 


2 


2 


Immediat en mode natif 65816 (M=0) 


EOR #const 


49 


3 


3 


Absolu 


EORaddr 


4D 


3 


4*(1) 


Absolu long 


EOR long 


4F 


4 


5»(1) 


Absolu index^ par X 


EORaddr,X 


5D 


3 


4 *(1,3) 


Absolu indexe par Y 


EORaddr,Y 


59 


3 


4 *(13) 


Absolu long indexe 


EORlong,X 


5F 


4 


5*(1) 


Direct 


EOR dp 


45 


2 


3 *(1,2) 


Direct indirect 


EOR (dp) 


52 


2 


5 *(1,2) 


Direct indirect indexe par Y 


EOR(dp),Y 


51 


2 


5*(1,2,3) 


Direct indirect long 


EOR <dp> 


47 


2 


6 *(1,2) 


Direct indirect long indexe par Y 


EOR<dp>,Y 


57 


2 


6*(1,2) 


Direct indexe indirect 


EOR (dp,X) 


41 


2 


6 *(1,2) 


Direct indexe par X 


EORdp,X 


55 


2 


4 *(1,2) 


Pile relative 


EOR sr,S 


43 


2 


4*(1) 


Pile relative indirecte indexee 


EOR(sr,S),Y 


53 


2 


7*(1) 



pour le calcul du nombre de cycles : 

(1) = ajouter 1 au nombre de cycles si M=0. 

(2) = ajouter 1 au nombre de cycles si V octet de poids faible du registre D 
(direct page register) est different de zero. 

(3) = ajouter 1 au nombre de cycles si I' addition du registre d' index fait 
changer de page memoire. 



INC 

(EMCrement) 

Une incrementation de 1 est effectuee sur le contenu d'un emplace- 
ment memoire sp^cifie par I'operande ou sur I'accumulateur. Si le 
contenu original de la memoire est de #$FF, le resultat sera alors de 
#$00. 
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Fonction : M < — M + 1 ou A < — A + 1 



Modification des registres : 



Registre d'etat 
du processeur 

Rcgistre 



N 
/ 

Ace 



V 



M 



Y 



D 



Mem 
/ 



Z 

/ 



Modes d'adressage 



Absolu 

Absolu indexe par X 

Accumulateur 

Direct 

Direct indexe par X 



Syntaxe 



Code Octet Cycle 



INCaddr 
INC addr,X 
INC A 
INC dp 
INC dp,X 



EE 
FE 
lA 
E6 
F6 



3 
3 
1 
2 

2 



6*(1) 
7*(1) 
2 

5 *(1,2) 

6 *(1,2) 



pour le calcul du nombre de cycles : 

(1) = ajouter 2 au nombre de cycles si M=0 

(2) = ajouter 1 au nombre de cycles si V octet de poids faible du registre D 
(direct page register) est different de zero. 

INX 

(INcrement index register X) 

Une incrementation de 1 est effectuee sur le registre d'index X. Si le 
contenu original du registre X est de #$FF, le resultat sera alors de 
#$00. 
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Fonction : X < — X + 1 



Modification des registres 



Registre d'etat N V 
du processeur / 


M 


X D 


I Z C 
/ 






Registre Ace X 

/ 


Y 


Mem 


/ 








Modes d'adressage 




Syntaxe 


Code Octet 


Cycle 




Implicite 




INX 


E8 1 


2 


INY 













(INcrement index register Y) 

Une incrementation de 1 est effectuee sur le registre d'index Y. Si le 
contenu original du registre Y est de #$FF, le resultat sera alors de 
fflpOU. 

Fonction : Y < — Y + 1 



Modification des registres : 



Registre d'etat N V 
duprocesseur / 

Registre Ace X 


M 

Y 
/ 


X D 
Mem 


I Z C 

/ 






Modes d'adressage 




Syntaxe 


Code Octet 


Cycle 


Implicite 




INY 


C8 1 


2 
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JML 

(JuMp Long) 

Cette instruction permet d'executer un saut dans un autre banc 
nnemoire k I'adresse specifiee par I'operande. Le registre PC (program 
counter) est charge avec I'aaresse de destination. Le registre PCB 
(program counter bank) est charg6 avec le 36me octet de I'adresse de 
cfestination specifiee par I'operande. 

Fonction : PC <— addr 

PB <— addr + 2 

Modification des registres : 



Registre d'etat N V M X D 

du registre ..... 

Registre Ace X Y Mem 



Modes d'adressage Syntaxe Code Octet Cycle 



Absolu indirect JML addr DC 



JMP 

(JuMP to new location) 

Cette instruction permet d'executer un saut k une adresse fixe speci- 
fiee dans le meme banc memoire. Dans le cas d'une adresse relative, 
il faut utiliser I'instruction BRA qui est enti^rement relogeable. 

Fonction : PC < — addr 

Modification des registres : 



Registre d'etat 
du processeur 

Registre 


N 
Ace 


V 
X 


M 


X 


D I 


Z 


C 


Y 


Mem 




• 


• 
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Modes d'adressage 



Absolu 

Absolu long 

Absolu indirect 

Absolu indirect index6 par X 



Syntaxe Code Octet Cycle 



JMPaddr 4C 

JMPlong 5C 

JMP(addr) 6C 

JMP(addr,X) 7C 



3 3 

4 4 
3 5 
3 6 



JSL 

(Jump to Sub routine Long / Inter-bank) 

Cette instruction permet un branchement h un sous-programme k 
n'importe quelle adresse de la memoire. 

Fonction : (S) <— PBR, S <— S - 1 

(S) <— PCH, S <— S - 1 
(S) <— PCL, S <— S - 1 
PC <— ADDR, PBR <— ADDR + 2 

Modification des registres : 



Registre d'etat 
du processeur 

Registre 



N 


V 


M- 




Ace 


X 


Y 



D 



Mem 



Modes d'adressage 



Absolu long 



JSL long 



22 



Syntaxe Code Octet Cycle 



JSR 

(Jump to SubRoutine) 

Cette instruction permet un branchement k un sous-programme k 
n'importe quelle adresse dans le banc utilise. 
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Fonction : (S) <— PCH, S <— S - 1 

(S) <— PCL, S <— S - 1 
PC <— ADDR 



Modification des regis tres : 



Registre d'etat N 
du processeur 

Registre Ace 


V 
X 


M X D 
Y Mem 


I Z 


C 






Modes d'adressage 


Syntaxe 


Code 


Octet 


Cycle 


Absolu 

Absolu indexe indirect 


JSRaddr 
JSR(addr,X) 


20 
FC 


3 
3 


6 
6 



LDA 

(LoaD Accumulator from memory) 

Chargement de I'accumulateur avec une valeur specifique ou avec la 
valeur situee h I'adresse donnee par I'operande. 

Fonction : A < — M 

Modification des regis ti"es : 



Registre d'etat 
du processeur 


N 
/ 


V 
X 


M 
Y 


X 

Mem 


D I 


Z 

/ 


c . 


Registre 


Ace 

/ 
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Modes d'adressage 



Syntaxe Code Octet Cycle 



Immediat en emulation 65C02 (M=l) 

Immediat en mode natif 65816 (M=0) 

Absolu 

Absolu long 

Absolu indexe par X 

Absolu indexe par Y 

Absolu long indexe par X 

Direct 

Direct indirect 

Direct indirect indexe par Y 

Direct indirect long 

Direct indirect long indexe par Y 

Direct indexe indirect 

Direct indexe par X 

Pile relative 

Pile relative indirecte indexee 



LDA #const 
LDA #const 
LDA addr 
LDA long 
LDA addr,X 
LDAaddr,Y 
LDA long,X 
LDA dp 
LDA (dp) 
LDA (dp),Y 
LDA <dp> 
LDA <dp>,Y 
LDA (dp,X) 
LDA dp,X 
LDA sr,S 
LDA (sr,S),Y 



A9 

A9 

AD 

AF 

BD 

B9 

BF 

A5 

B2 

Bl 

A7 

B7 

Al 

B5 

A3 

B3 



2 
3 
3 
4 
3 
3 
4 
2 
2 
2 
2 
2 
2 
2 
2 
2 



2 
3 

4*(1) 
5»(1) 
4 *(U) 

4 *(13) 
5*0) 
3*(1,2) 

5 *(1,2) 
5*(1,2,3) 
6*(1,2) 

6 *(U) 
6*(1,2) 
4 *(1,2) 
4*(1) 
7*(1) 



pour le calcul du nombre de cycles : 

(1) = ajouter 1 au nombre de cycles si M=0 

(2) = ajouter 1 au nombre de cycles si V octet de voids faible du re^istre D 
(direct page register) est different de zero. 

(3) = ajouter 1 au nombre de cycles si I'addition du registre d'index fait 
changer de page memoire. 



LDX 



(LoaD index register X from memory) 



Chargement du registre d'index X avec une valeur specifique ou avec 
la valeur situee h. radresse donnee par I'operande. 
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Fonction : X <— M 



Modification des registres 



Registre d'etat 
du processeur 

Registre 



N V M X D 

/ . . . . 

Ace X Y Mem 
/ 



Z 

/ 



Modes d'adressage 



Syntaxe 


Code Octet 


Cycle 


LDX #const 


A2 


2 


2 


LDX #const 


A2 


3 


3 


LDXaddr 


AE 


3 


4»(1) 


LDXaddr,Y 


BE 


3 


4 *(U) 


LDX dp 


A6 


2 


3*(U) 


LDXdp,Y 


B6 


2 


4 *(i;2) 



Immediat en emulation 65C02 (M=l) 

Iminediat en mode natif 65816 (M=0) 

Absolu 

Absolu index6 par Y 

Direct 

Direct indexe par Y 



pour le caleul du nombre de cycles : 

(1) = ajouter 1 au nombre de cycles si X=0 

(2) = ajouter 1 au nombre de cycles si V octet de poids faible du registre D 
(direct page register) est different de zero. 

(3) = ajouter 1 au nombre de cycles si V addition du registre d'index fait 
changer de page memoire. 



LDY 



(LoaD index register Y from memory) 



Chargement du registre d'index Y avec une valeur specif ique ou avec 
la valeur situ^ ^ 1 ac' 



adresse donn^ par I'op^rande. 
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Fonction : Y < — M 



Modification des registres 



Registre d'etat 
du processeur 

Registre 



N V M X D 
/ . . . . 

Ace X Y Mem 



Z C 

/ 



Modes d'adressage 



Syntaxe Code Octet Cycle 



Immediat en emulation 65C02 (M=l ) LDY #const 

Immediat en mode natif 65816 (M=0) LDY #const 

Absolu LDYaddr 

Absolu mdexe par X LDY addr,X 

Direct LDY dp 

Direct indexe par X LDY dp,X 



AO 
AO 
AC 
BC 
A4 
B4 



2 2 

3 3 

3 4 *(1) 

3 4*0^) 

2 3 »(1,2) 

2 4 *(1,2) 



pour le calcul du nombre de cycles : 

(1) = ajouter 1 au nombre de cycles si X=0. 

(2) = ajouter 1 au nombre de cycles si V octet de voids faible du registre D 
{direct page register) est different de zero. 

(3) = ajouter 1 au nombre de cycles si I' addition du registre d'index fait 
changer de page memoire. ' 



LSR 

(Logical Shift memory or accumulator Right) 

On d^cale ^ droite I'accumulateur ou le contenu d'une memoire En 
mode 8 bits (Emulation 65C02) le bit 7 est mis ^ zero, tandis que le bit 
est transf^r^ dans la retenue. En mode 16 bits le bit 15 est mis k zero 
tandis que le bit est transf^r^ dans la retenue. Cette operation 
consiste en fait k une division par 2. 
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Fonction : 







nir\r\ninir\r\ 



















X 



Modification des registres 



Registrc d'etat 
du processcur 

Registre 



N 


Ace 
/ 



Modes d'adressage 



Syntaxe 



Absolu 

Absolu indexe par X 

Accumulateur 

Direct 

Direct indexe par X 



LSRaddr 

LSRaddr,X 

LSRA 

LSRdp 

LSRdp,X 



CARRY 



Code Octet Cycle 



4E 
5E 
4A 
46 
56 



3 
3 
1 
2 
2 



6*(1) 

7*(1) 

2 

5 *(1,2) 

6*(1,2) 



\/ 



M 


X 


D 


I 


Z 

/ 


C 

/ 


Y 


Mem 
/ 











pour le calcul du nombre de ancles : 

(1) = ajouter 2 au nombre de cycles si M=0. 

(2) = ajouter 1 au nombre de cycles si V octet de poids faible du registre D 
(direct page register) est different de zero. 
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MVN 

(block MoVe Next) 

Cette instruction deplace un bloc memoire d'un endroit dans la 
memoire h un autre. Ce deplacement est effectue en commengant par 
les adresses les plus basses du bloc k deplacer. Lors de cette operation, 
leregistre d'index X contient I'adresse de depart, et le registre d'index 
Y contient I'adresse de destination du bloc. Ces registres sont incre- 
mentes apr^s chaque deplacement. 

L'accumulateur contient le nombre d'octets k deplacer moins 1. II est 
evidemment decremente apr6s chaque transfert. 
Fonction : 

M <— M, X <— X + 1, Y <— Y + 1, A <— A - 1, DBR <— N 



Modification des registres : 



Registre d'etat 
du processcur 

Registre 



N 



Ace 



V 



M 



Y Mem 



D 



Z C 



Modes d'adressage 



Bloc de depart -> destination 
(source,destination) 



Syntaxe Code Octet Cycle 



MVN- 



54 



'MVNsrcblk4estblk 



■ 7 a/cles par octet deplace 
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MVP 

(block MoVe Previous) 

Cette instruction d^place un bloc memoire d'un endroit dans la 
m^moire k un autre. Ce d^placement est effectu^ en commengant par 
les adresses lesplus hautes du bloc k deplacer. Lors de cette operation, 
le registre d'index X contient I'adresse de depart, et le registre d'index 
Y contient I'adresse de destination du bloc. Ces registres sont decr^ 
mentis apr^s chaque d^placement. 

L'accumulateur contient le nombre d'octets h deplacer moins 1. II est 
decrements apr^s chaque transfert. 
Fonction : 

M<— M,X<— X-1,Y<— Y-1,A<— A-1,DBR<— N 

Modification des registres : 



Registre d'etat 


N 


V 


du processeur 




. 








Registre 


Ace 

/ 


X 

/ 



M X D 



Y Mem 
/ / 



Modes d'adressage Syntaxe Code Octet Cycle 



Bloc d'origine -> destination MVP * 44 

(source,destination) 



* MVP srcbk4estbk »* 7 cycles par octet deplace 

NOP 

(No operation) 

ti fflieF8pF86g§§suF R'iffisftii luaiRi splFition piR^aRt 2 ayaiig 

Seul le registre PC (program counter) est affecte, puisqu'il est incr^ 
mentf de fagon h. exScuter la prochaine operation. Cette instruction 
est utilisee dans la correction de programmes, ou pour synchroniser 
des animations. 



58 
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Fonction : / 



Modification des registres : 



Registre d'etat: 
du processeur 

Registre 



N 



Ace 



M 



Y Mem 



D 



Modes d'adressage 



Implicite 



NOP 



Syntaxe Code Octet Cycle 



EA 



ORA 

(OR Accumulator with memory) 

Cette instruction effectue un OU logique entre le contenu de la 
m^moire et 1 accumulateur. Cette operation est effectuee bit ^ bit entre 
1 accumulateur et les bits correspondants en memoire. Le resultat est 
stocke en A. 

Ou inclusif suit la table de verity suivante : 



Deuxi^me op^rande 
Premiere op^rande 








1 








1 


1 


1 


1 
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Fonction : A < — A V M 



Modification des registres 













D 


I Z 

/ 


C 


Registre d'etat 


N 


V 


M 


X 


du processeur 


/ 


X 


Y 


Mem 

/ 


Registre 


Ace 

/ 



Modes d'adressage 


Syntaxe Code Octet 


Cycle 


Immediat en emulation 65C02 (M=l) 


ORA #const 


09 


2 


2 


Inunediat en mode natif 65816 (M=0) 


ORA #const 


09 


3 


3 


Absolu 


ORA addr 


OD 


3 


4*(1) 


Absolu long 


ORA long 


OF 


4 


5*(1) 


Absolu indexe par X 


ORA addr,X 


ID 


3 


4 *(1,3) 


Absolu indexe par Y 


ORAaddr,Y 


19 


3 


4 *(1,3) 


Absolu long indexe 


ORA long,X 


IF 


4 


5*(1) 


Direct 


ORA dp 


05 


2 


3 *(1,2) 


Direct indirect 


ORA (dp) 


12 


2 


5*0,2) 


Direct indirect indexe par Y 


ORA(dp),Y 


11 


2 


5*(1,2,3) 


Direct indirect long 


ORA <dp> 


07 


2 


6*(1,2) 


Direct indirect long indexe par Y 


ORA<dp>,Y 


17 


2 


6*(1,2) 


Direct indexe indirect 


ORA(dp,X) 


01 


2 


6 '(1,2) 


Direct indexe par X 


ORAdp,X 


15 


2 


4 •(1,2) 


Pile relative 


ORA sr,S 


03 


2 


4»(1) 


Pile relative indirecte indexee 


ORA (sr,S),Y 


13 


2 


7»(1) 



pour le calcul du nombre de cycles : 

(1) = ajouter 1 au nombre de cycles si M=0. 

(2) = ajouter 1 au nombre de cycles si I' octet de poids faible du registre D 
(direct page register) est different de zero. 

(3) = ajouter 1 au nombre de cycles si V addition du registre d'index fait 
changer de page memoire. 
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PEA 

(Push Effective Absolute address on the stack) 

Les 16 bits (2 octets) de donnees suivant immediatement PEA sont 
stockes au sommet de la pile, dans I'ordre suivant : d'abord le troi- 
si^me octet puis le second. Le pointeur de pile est mis k jour. 

Fonction : (S) <— PC + 1, S <— S - 1 

(S) <— PC + 2, S <— S - 1 

Modification des registres : 



Registre d'etat N V M X D 

duprocesseur ..... 

Registre Ace X Y Mem 



Modes d'adressage Syntaxe Code Octet Cycle 



Pile PEA addr F4 



PEI 

(Push Effective Indirect address on the stack) 

Les bits du registre direct (Registre D) et I'octet de donnees suivant 
I'instruction sont additionnes, et stockes ensuite au sommet de la pile, 
les bits de poids forts sont places en premier lieu, et les bits de poids 
faible en second. Le registre D n'est pas affecte par cette operation. Le 
pointeur de pile est mis k jour. 
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Fonction : (S) <— (D + (PC + 1)), S <— S - 1 

(S) <— (D + (PC + 1) + 1), S <— S - 1 

Modification des registres : 



Registre d'etat 
du procGsseur 


N 


V 


M 


X 


D I 


Z 


C 










• 




























Registre 


Ace 


X 


Y 


Mem 


• 



Modes d'adressage 



Syntaxe Code Octet Cycle 



Pile (direct indirect) 



PEI (dp) D4 



6»(1) 



pour le calcul du nombre de cycles : 

(1)= ajouter 1 au nombre de cycles si les bits depoidsfaible du registre Dsont 
differ ents de zero. 



PER 

(Push Effective program counter Relative address on the stack) 

Cette instruction additionne le contenu du registre PC (Program 
counter) et les deux octets de donnas suivant I'instruction. La valeur 
obtenue est stock^e au sommet de la pile, et le pointeur de pile est mis 
^ jour. 
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Fonction : (S) <— PC + NN + 2, S <— S - 2 
Modification des registres : 



Registre d'etat N V M X D 
duprocesseur ..... 



Registre Ace X Y Mem 



Modes d'adressage Syntaxe Code Octet Cycle 



Pile (relatif long) PER label 62 



PHA 

(PusH Accumulator) 

Le contenu de I'accumulateur est plac6 au sommet de la pile. Le 
pointeur de pile est mis h jour. L'accumulateur n'est pas modifi^. 
Si le processeur est en mode natif, les deux octets sont places au 
sommet de la pile dans I'ordre suivant : les bits de poids fort sont 
places en premier lieu et les bits de poids faible en second. Le pointeur 
de pile est d^cr^ment^ de 2. 

Fonction : (S) <— A, S <— S - 1 ou S <— S - 2 

Modification des registres : 



Registre d'etat N V M X D I 

du processeur , . . 

Registre Ace X Y Mem 



Modes d'adressage Syntaxe Code Octet Cycle 



Pile PHA 48 1 3*(1) 
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pour le calcul du nomhre de cycles : 

(1) = ajouter 1 au nomhre de cycles si M=0 

PHB 

(PusH data Bank register on the stack) 

Le contenu du registre DBR (Data bank register), est place au somnnet 
de la pile. Le pointeur de pile est mis a jour. 

RAPPEL : le registre DBR est un registre 8 bits. 

Fonction : (S) <— DBR, S <— S - 1 

Modification des registres : 



Registre d'etat N V M X 

du processcur .... 

Registre Ace X Y Mem 




Modes d'adressage 


Syntaxe 


Code 


Octet 


Cycle 


Pile 


PHB 


8D 


1 


3 



PHD 

(PusH Direct page register on the stack) 



Cette instruction place le contenu du registre D (registre direct - 1 6 bits) 
au sommet de la pile, le pointeur de pile S est mis k jour. 
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Fonction : (S) <— D, S <— S - 2 



Modification des registres : 



Registrc d'etat 
du processcur 

Registre 



N V M X 



Ace 



D 



Y Mem 



Modes d'adressage 



Pile 



PHD 



Syntaxe Code Octet Cycle 



OB 



PHK 

(PusH program banK register on the stack) 

Cette instruction place le contenu du registre PBR (Program bank 
register - 8 bits) au sommet de la pile, le pomteur de pile est mis h jour. 

Fonction : (S) <— PBR, S <— S - 1 

Modification des registres : 



Registre d'etat 


N 


V 


M 


X 


D 


I 


Z 


■ c:liiiliiiliiiii 


du processcur 


:;:;:;;;::;:;::;•: ■■:; 


• 


• 


• 


• 


• 


• 


|;;::::.;|'|||:;||||;|||| 


Registre 


' Acc ■ 


X 


Y 


Mem 








^^MMMfMlimmi 



Modes d'adressage 



Pile 



PHK 



Syntaxe Code Octet Cycle 



4B 
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PHP 

(PusH Processor status register) 

Cette instruction place le contenu du registre d'etat du processeur au 
sommet de la pile. Le registre d'etat P n'est pas affecte par cette 
instruction. Le pointeur de pile est mis k jour. 

Fonction : (S) <— P, S <— S - 1 

Modification des registres : 



Registre d'etat N V M X D 

du processeur ..... 

Registre Ace X Y Mem 



Modes d'adressage Syntaxe Code Octet Cycle 



Pile PHP 08 1 



PHX 

(PusH index register X) 

Cette instruction place le contenu du registre d'index X au sommet de 
la pile. Le registre d'index X n'est pas affecte par cette instruction. Le 
pomteur de pile (S) est mis k jour. 

Si le processeur est en mode natif, les deux octets sont places au 
sommet de la pile et le pointeur de pile est decremente de 2. 
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Fonction : (S) <— X, S <— S - 1 ou S <— S - 2 



Modification des registres : 



Registre d'etat 
du processeur 

Registre 



N V 



Ace 



M 



D 



Y Mem 



Modes d'adressage 



Pile 



Syntaxe Code Octet Cycle 



PHX 



DA 



3*(1) 



pour le calcul du nombre de cycles : 

(1) = ajouter 1 au nombre de cycles si X=0 



PHY 



(PusH index register Y) 



Cette instruction place le contenu du registre d'index Y au sommet de 
la pile. Le registre d'index Y n'est pas atfecte par cette instruction. Le 

gointeur de pile (S) est mis h. jour, 
i le processeur est en mode natif, les deux octets sont places au 
sommet de la pile et le pointeur de pile est decremente de 2. 

Fonction : (S) <— \, S <— S - 1 ou S <— S - 2 



Modification des registres : 



Registre d'etat 
du processeur 

Registre 


N 
Ace 


V 
X 


M 
Y 


X 

Mem 



D 
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Modes d'adressage 


Syntaxe 


Code Octet 


Cycle 


Pile 


PHY 


5A 1 


3*(1) 



pour le calcul du nombre de cycles : 

(1) = ajouter 1 au nombre de cycles si X=0 

PLA 

(PulL Accumulator) 

Cette instruction place le contenu du sommet de la pile dans I'accu- 
mulateur. Le pointeur de pile (S) est n\is h jour. 
Si le 65C816 est en mode natif ce sont les deux octets (16 bits) qui sont 
transferes de la pile vers I'accumulateur. Le pointeur de pile est alors 
incremente de 2. 

Fonction : S <— S + 1 ou S <— S + 2, A <— (S) 

Modification des registres : 



Registre d'etat N V 
du processcur / 

Registre Ace X 


M 
Y 


X D 
Mem 


I Z C 

/ 


,::y:;i;;^:ox;;;:;:;:;:;>;;:;:;:; 


/ 










• 








Modes d'adressage 




Syntaxe 


Code Octet 


Cycle 


Pile 




PLA 


68 1 


4*0) 



pour le calcul du nombre de cycles : 

(1) = ajouter 1 au nombre de cycles si M=0 
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PLB 

(PulL data Bank register) 

Cette instruction transf^re le contenu du sommet de la pile, au registre 
DBR (Data bank register). Le pointeur est mis h jour. 

Fonction : S <— S + 1, DBR <— (S) 

Modification des registres : 



Registre d'etat N V 
du processeur / 

Registre Ace X 


M X D 

• ♦ ■ 

Y Mem 


I Z C 

/ 


il^i'yr^-yivivi^v'viv:-:';":-^^^^ 




Modes d'adressage 


Syntaxe 


Code Octet 


Cycle 


Pile 


PLB 


AB 1 


4 


PLD 

(PulL Direct page re 


gister) 







Cette instruction transf^re le contenu du sommet de la pile, au registre 
D (Registre direct). Le pointeur est mis k jour. 

Fonction : S <— S + 2, D <— (S) 



Modification des registres : 



Registre d'etat N V 
du processeur / 



Registre 



Ace 



M 



Y Mem 



D 



Z 

/ 



c 
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Modes d'adiessage Syntaxe Code Octet Cycle 



Pile PLD 2B 1 



PLP 

(PulL status flag) 

Cette instruction transfere le contenu du sommet de la pile, au registre 
d'etat du processeur (Registre P). Le pointeur est mis k jour. 

Fonction : S <— S + 1, P <— (S) 

Modification des registres : 



Registre d'etat N V M X D I Z C 
du processeur I I I I I I I I 

Registre Ace X Y Mem 



Modes d'adressage Syntaxe Code Octet Cycle 



Pile PLP 28 



PLX 

(PulL index register X) 

Cette instruction transfere le contenu du sommet de la pile au registre 
d'index X. Le pointeur de pile (S) est mis k jour. 
Si le 65C816 est en mode natif ce sont les deux octets (16 bits) qui sont 
transf^r^s de la pile vers le registre d'index X. Le pointeur de pile est 
alors incr^mente de 2. 
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Fonction : S <— S + 1 ou S <— S + 2, X <— (S) 

Modification des registres : 



Registre d'etat 
du processeur 

Registre 


N 
/ 

Ace 


V 
X 

/ 


M 
Y 


X D 

Mem 


I z c 

/ 


liiilillilli 




Modes d'adressage 




Syntaxe 


Code Octet 


Cycle 




Pile 






PLX 


FA 1 


4*(1) 



pour le calcul du nombre de cycles : 

(1) = ajouter 1 au nombre de cycles si X=0 

PLY 

(PulL index register Y) 

Cette instruction transf^re le contenu du sommet de la pile au registre 
d'index Y. Le pointeur de pile (S) est mis h jour. 
Si le 65C816 est en mode natif ce sont les deux octets (16 bits) qui sont 
transf^r^s de la pile vers le registre d'index Y. Le pointeur de pile est 
alors incr^mente de 2. 

Fonction : S <— S + 1 ou S <— S + 2, Y <— (S) 

Modification des registres : 



Registre d'etat 
du processeur 

Registre 


N 

7 

Ace 


y 

X 


M 

Y 

/ 


X 

Mem 


* 


I 


Z 

/ 


'■ '■ ~ — : ■ .':■:■:■:.!.'■:■ 

C:s;|||||||||| 
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Modes d'adiessage 



Syntaxe Code Octet Cycle 



Pile 



PLY 



7A 



4*(1) 



pour le calcul du nombre de cycles : 

(1) = ajouter 1 au nombre de cycles si X =0 

REP 

(REset Processor status bits) 



Cette instruction effectue un ET bits k bits entre le registre d'etat du 
processeur et le complement de I'octet suivant immediatement I'ins- 
truction. 

Fonction : P <— P '^ N 



Modification des registres : 



Registre d'etat N V 
du processeur 


M 


X D 


I Z 


C 










{mode emulation) / / 
(mode natif) / / 
Registre Ace X 


/ 
Y 




/ 
/ / 
Mem 


/ / 
/ / 


/ 
/ 








Modes d'adressage 




Syntaxe 


Code 


Octet 


Cycle 


Immediat 




REP #const 


C2 


2 


3 
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ROL 

(Rotate memory or accumulator Left) 



Fonction : 



f\f\f\f\f\f\f\ 



1 





1 





1 





1 







CARRY 



Cette instruction decale tous les bits de I'accumulateur ou du contenu 
de I'adresse memoire specifi^e par I'operande de 1 vers la gauche. En 
mode 16 bits le bit est mis h la place du bit 1, le bit de report est mis 
k la place du bit 0, le bit 15 est mis h la place du bit de report, le bit 14 
est mis k la place du bit 15 et ainsi de suite. 

En mode 8 bit le bit est mis h la place du bit 1, le bit de report est mis 
h la place du bit 0, le bit 7 est mis h la place du bit de report et ainsi de 
suite. 



Modification des registres : 



Registre d'etat 
du processeur 

Registre 



N 
/ 

Ace 
/ 



V 



M X D 



Y Mem 
/ 



Z 

/ 



C 

/ 



Modes d'adressage 



Syntaxe 



Code Octet Cycle 



Absolu 

Absolu indexe par X 

Accumulateur 

Direct 

Direct indexe par X 



ROL addr 
ROL addr,X 
ROL A 
ROL dp 
ROL dp,X 



2E 
3E 
2A 
26 
36 



6*(1) 

7*(1) 

2 

5*(1,2) 

6*(1,2) 
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pour le calcul du nomhre de cycles : 

(1) = aj'outer 2 au nomhre de cycles si M=0. 

(2) = ajouter 1 au nomhre de cycles si V octet de voids faihle du re^istre D 
(direct page register) est different de zero. 

ROR 

(Rotate memory or accumulator Right) 
Fonction : 



^v:v;v3^^A 




CARRY 



Cette mstruction decale tous les bits de I'accumulateur ou du contenu 
de I'adresse m^moire sp^cifi^e par I'op^rande d'un vers la droite. En 
mode 16 bits le bit 1 est mis ^ la place du bit 0, le bit est mis ^ la place 
du bit de report, le bit de report est mis ^ la place du bit 15, le bit 15 est 
mis h. la place du bit 14 et ainsi de suite. 

En mode 8 bit le bit 1 est mis h. la place du bit 0, le bit est mis h. la place 
du bit de report, le bit de report est mis h. la place du bit 7 et ainsi de 
suite. 



Modification des registres 



Rpp-icfrp H'^f^f 


w 


V 


M 


X 


D 


I 


Z 

/ 


'}'^^^, 


du processeur 


/ 












Rcgistre 


Ace 

/ 


X 


Y 


Mem 

/ 

















74 
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Modes d'adressage Syntaxe Code Octet Cycle 



Absolu RORaddr 6E 3 6*(1) 

AbsoluindexeparX RORaddr,X 7E 3 7*(i) 

Accumulateur ROR A 6A 1 2 

Direct ROR dp 66 2 5*(12) 

Direct indexe par X RORdp,X 76 2 6*(1,2) 



pour le calcul du nombre de cycles : 

(1) = ajouter 2 au nombre de cycles si M=0. 

(2) = ajouter 1 au nombre de cycles si V octet de voids faible du registre D 
(direct page register) est different de zero. 



RTI 

(ReTurn from Interrupt) 

Cette instruction charge le registre d'etat du processeur, le reeistre 
deTa^*tr ° ' ^* ^^ J'egistre PBR (programl)ank register) k partir 

Fonction : S <— S + 1, P <_ (S) 

S <— S + 1, PCL <— (S) 

S <— S + 1, PCH <— (S) 

S <— S + 1, PBR <— (S) 

Modification des registres : 



Registre d'etat N V M X D I Z C 
du prcxresseur 

(Mode emulation) / / , . / / / / 

(Modenatif) / /// I I I I 

Registre Ace X Y Mem 
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Modes d'adressage 



Syntaxe 



Code Octet Cycle 



Pile 



RTI 



40 



1 



6*(1) 



pour le calcul du notnbre de q/cles : 

(1) = ajouter 1 au nombre de cycles si E=0 (mode natifdu 65C816) 

RTL 

(ReTurn from subroutine Long) 

Cette instruction ^quivaut k un RETURN en Basic. Cette instruction 
restitue au registre PC (program counter) I'adresse incr^mentee d'un, 
contenue dans la pile. Cette instruction est utilisee avec JSL. L'instruc- 
tion RTL permet un retour dans n'importe quel banc m^moire. 



Fonction : S <— S + 1, PCL <— (S) 

S <— S + 1, PCH <— (S) 
S <— S + 1, PBR <— (S) 



Modification des registres : 



Registre d'etat 
du processeur 

Registre 


N 
Ace 


V 


M 


X 


D 


I Z 


c 


X 






* 


. 


. 










Y 


Mem 














• 


• 


• 







Modes d'adressage 


Syntaxe 


Code 


Octet 


Cycle 


Pile 


RTL 


6B 


1 


6 
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RTS 

(ReTurn from Subroutine) 

Cette instruction ^quivaut k un RETURN en Basic. Cette instruction 
restitue au registre PC (program counter) I'adresse incrementee d'un, 
contenue dans la pile. Cette instruction est utilisee avec JSR. L'instruc- 
tion RTS ne permet un retour que dans le banc memoire courant. 

Fonction: S<— S + 1,PCL <— (S) 

S <— S + 1, PCH <— (S) 

Modification des registres : 



Registre d'6tat 
du processeur 

Registre 



N 



Ace 



M 



X 



Mem 



D 



Modes d'adressage 



Pile 



Syntaxe Code Octet Cycle 



RTS 



60 



SBC 

(Substract with Borrow from accumulator) 

L'accumulateur est soustrait avec le complement du bit de report au 
contenu d'une adresse memoire ou d'une valeur specifiee par I'ope- 
rande. Le resultat est stocke dans l'accumulateur. 
Afin que lebit de report n'ai pas d'influence sur la soustraction, il faut 
utiliser I'instruction SEC (SEt Carry Flag) avant d'utiliser SBC. 
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Fonction ; A < — A - M - C 



Modification des registres : 



Registre d'etat 
du processeur 

Registro 



N 
/ 

Ace 
/ 



V 

/ 


M 


X 


D 


I 


Z 


c 








■ 


/ 


/ 


X 


Y 


Mem 











Modes d'adressage 


Syntaxe 


Code 


Octet Cycle 


Immediat en emulation 65C02 (M=l) 


SBC #const 


E9 


2 


2 


Immediat en mode natif 65816 (M=0) 


SBC #const 


E9 


3 


3 


Absolu 


SBCaddr 


ED 


3 


4*(1) 


Absolu long 


SBC long 


EF 


4 


5*(1) 


Absolu indexe par X 


SBCaddr,X 


FD 


3 


4 *(1^) 


Absolu indexe par Y 


SBCaddr,Y 


F9 


3 


4 *(U) 


Absolu long indexe 


SBClong,X 


FF 


4 


5*(1) 


Direct page zero 


SBC dp 


E5 


2 


3 *{\,2) 


Direct indirect 


SBC (dp) 


F2 


2 


5*(1,2) 


Direct indirect indexe par Y 


SBC(dp),Y 


Fl 


2 


5*(1,2,3) 


Direct indirect long 


SBC <dp> 


E7 


2 


6*(1,2) 


Direct indirect long indexe par Y 


SBC<DP>,Y 


F7 


2 


6*(1^) 


Direct indexe indirect 


SBC(dp),Y 


El 


2 


6 »(1,2) 


Direct indexe par X 


SBCdp,X 


F5 


2 


4 *(1,2) 


Pile relative 


SBC sr,S 


E3 


2 


4*(1) 


Pile relative indirecte indexee 


SBC(sr,S),Y 


F3 


2 


7*(1) 



pour le calcul du nombre de cycles : 

(1) = ajouter 1 au nombre de cycles si M=0. 

(2) = ajouter 1 au nombre de cycles si I' octet de poidsfaible du registre D 
(direct page register) est different de zero. 

(3) = ajouter 1 au nombre de cycles si V addition du registre d'index fait 
changer de page memoire. 
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SEC 

(SEt Carry flag) 

Le bit C (Carry flag ou bit de retenue) du registre d'etat du processeur 
est mis a 1. Cette instruction est souvent utilisee avant SBC ou XCE. 

Fonction ; C < — 1 

Modification des registres : 



Registre d'etat N 
du processeur 

Registre Ace 


V 
X 


M X D 
Y Mem 


I z c 

1 


illlilllil 




Modes d'adressage 


Syntaxe 


Code Octet 


Cycle 


Implicite 




SEC 


38 1 


2 



SED 

(SEt Decimal mode flag) 

Le bit D (Decimal flag) du registre d'etat du processeur est mis k 1, ce 
qui fait passer le 65C816 en mode decimal code binaire (BCD - Binary 
coded Decimal). ■' 

Fonction : D < — 1 



Modification des registres : 



Registre d'etat 


N 


V 


M X 


D 


I Z 


C , 


du processeur 


- 


• 


• 


1 


• 




Registre 


Ace 


X 


Y Mem 
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Modes d'adressage 


Syntaxe 


Code 


Octet 


Cycle 


Implicite 


SED 


F8 


1 


2 



SEI 

(SEt Interrupt disable flag) 

Le bit I (Interrupt flag) du registre d'etat du processeur est mis k 1, ce 
qui le desactive. Cette instruction a pour but de masquer les interrup- 
tions IRQ (Interrupt ReQuest). Cette instruction ne met pas hors 
d'usage les interruptions non masquables (MNI - non masquable 
interrupt ou RESETj. 

Fonction : I < — 1 

Modification des registres : 



Registre d'etat N V M X D I 

du processeur . .... 1 

Registre Ace X Y Mem 



Modes d'adressage Syntaxe Code Octet Cycle 



Implicite SEI 78 1 



SEP 

(SEt Processor status bits) 

Cette instruction permet de modifier n'importe quel (s) bit (s) dans le 
registre d'etat du processeur (P) avec le bit correspondant de I'ope- 
rande de I'instruction. 
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Fonction : P < — P V N 



Modification des registres 



Registre d'etat N 
du processcur 

(Mode Emulation) / 

(ModenatiO / 


V 

/ 


M 


X 

/ 
Mem 


D 

/ 

/ 


I Z C 

/ / / 




/ 


/ 
Y 


/ / / 




Registre Ace 


X 


• 








Modes d'adressage 




Syntaxe 


Code Octet 


Cycle 


Imm#diat 






SEP#const 


E2 2 


3 



STA 

(Store Accumulator to memory) 

Cette instruction stocke I'accumulateur en memoire. 

2 possibilit^s : 

L'accumulateur est en mode 8 bits : La valeur dans I'accumulateur est 
mise k I'adresse memoire sp^cifi^e par I'operande. 

L'accumulateur est en mode 16 bits : les 8 bits depoids faible de I'ac- 
cumulateur sont mis k I'adresse memoire specifiee par I'operande, et 
les 8 bits de poids forts sont mis k I'adresse memoire specifiee par 
1 operande plus une. 
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Fonction : M < — A 



Modification des registres : 



Registre d'etat N 
du prcKesseur 



Registre 



V 



Ace 



M 



Y Mem 
/ 



D 



Modes d'adressage 


Syntaxe 


Code 


Octet 


Cycle 


Absolu 


STAaddr 


8D 


3 


4 


Absolu long 


STA long 


8F 


4 


5 


Absolu ind^xe par X 


STAaddr,X 


9D 


3 


5*a) 


Absolu indexe par Y 


STAaddr,Y 


99 


3 


5»(1) 


Absolu long indexe par X 


STAlong,X 


9F 


4 


5*(1) 


Direct page zero 


STA dp 


85 


2 


3 *(U) 


Direct indirect 


STA (dp) 


92 


2 


5 *(1,2) 


Direct indirect indexe par Y 


STA(dp),Y 


91 


2 


6*(1,2) 


Direct indirect long 


STA <dp> 


87 


2 


6*(1,2) 


Direct indirect long indexe par Y 


STA<dp>,Y 


97 


2 


6*(1,2) 


Direct indexe indirect 


STA (dp,X) 


81 


2 


6*(1,2) 


Direct indexe par X 


STAdp,X 


95 


2 


4 *(1,2) 


Pile relative 


STA sr,S 


83 


2 


4*(1) 


Pile relative indirecte indexee 


STA(sr,S),Y 


93 


2 


7*a) 



pour le calcul du nombre de cycles : 

(1) = ajouter 1 au nombre de cycles si M=0. 

(2) = ajouter 1 au nombre de cycles si V octet de poids faible du registre D 
(direct page register) est different de zero. 

STP 

(STop the Processor) 

Cette instruction arrdte le microprocesseur. RESET est la seule fagon 
pour reprendre les operations. 



82 
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' 



Fonction : Arret du microprocesseur. 



Modification des registres : 



Registre d'etat 
du processeur 

Registre 



N 



Ace 



V 



M 



Y Mem 



D 



Modes d'adressage 


Syntaxe 


Code 


Octet 


Cycle 


Implicite 


STP 


DB 


1 


3 



STX 

(STore index register X to memory) 

Cette instruction stocke le registre d'index X en memoire. 

II y a 2 possibilites : 

Le registre d'index X est en mode 8 bits : La valeur dans le rejgistre 
d'index X est mise k I'adresse memoire specifiee par I'operande. 
Le registre d'index X est en mode 16 bits : les 8 bits de poids faible du 
registre d'index X sont mis h I'adresse memoire specifiee par I'ope- 
rande, et les 8 bits de poids fort sont mis k I'adresse memoire specifiee 
par I'operande plus une. 

Fonction : M < — X 



Modification des registres : 



Registre d'etat N 


V 


M 
Y 


X 


D 


I Z 

* 


C 


■vfiiM 


du processeur 
Registre Ace 


X 


Mem 
/ 
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Modes d'adressage 



Syntaxe Code Octet Cycle 



Absolu 

Direct 

Direct indexe par Y 



STX addr 
SIX dp 
STX dp,Y 



8E 3 4 *(1) 
86 2 3 *(1,2) 
96 2 4 *(1,2) 



pour le calcul du nombre de cycles : 

(1) = ajouter 1 au nombre de cycles si X=0. 

(2) = ajouter 1 au nombre de cycles si I' octet de poids faible du registre D 
(direct page register) est different de zero. 



STY 

(STore index register Y to memory) 

Cette instruction stocke le registre d'index Y en memoire. 
2 possibilit^s : 

Le registre d'index Y est en mode 8 bits : La valeur dans le registre 
d'index Y est mise k I'adresse memoire specifiee par I'operancie. 
Le registre d'index Y est en mode 16 bits : les 8 bits de poids faible du 
registre d'index Y sont mis h I'adresse memoire specifiee par I'ope- 
rande, et les 8 bits de poids fort sont mis k I'adresse memoire specifiee 
par I'operande plus une. 

Fonction : M < — Y 



Modification des registres 







V 
X 


M 
Y 


X 

Mem 
/ 


D 


I Z 


C 


Registre d'etat 
du processeur 

Recistrc 


N 
Ace 











84 
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Modes d'adressage 


Syntaxe 


Code 


Octet Cycle 


Absolu 

Direct 

Direct indexe par Y 


STYaddr 
STY dp 
STYdp,X 


8C 
84 
94 


3 4 »(1) 
2 3*a,2) 
2 4 »(1,2) 



pour le calcul du nombre de cycles : 

(1) = ajouter 1 au nombre de cycles si X=0. 

(2) = ajouter 1 au nombre de cycles si V octet de poidsfaible du registre D 
(direct page register) est different de zero. 

STZ 

(STore Zero to memory) 

Cette instruction stocke la valeur zero, h I'adresse memoire specifi^e 

par I'op^rande si le microprocesseur est en mode 8 bits. 

Si le microprocesseur est en mode 16 bits (M=0), cette instruction 

stocke la valeur zero k I'adresse memoire specifiee par I'operande et 

k I'adresse memoire specific par I'operande plus une. 

Fonction : M < — 



Modification des registres 



Registre d'etat 
du processeur 

Registre 



N V M X D 



Ace X Y Mem 
/ 



C 



Modes d'adressage 



Absolu 

Absolu indexe par X 
Direct page zero 
Direct indexe par X 



Syntaxe 



STZ addr 
STZaddr,X 
STZ dp 
STZ dp,X 



Code Octet Cycle 



9C 
9E 
64 

74 



3 4 *(1) 

3 5*(1) 

2 3 *(1,2) 

2 4 *(1,2) 
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pour le calcul du nombre de cycles : 

(1) = ajouter 1 au nombre de cycles si M=0. 

(2) = ajouter 1 au nombre de cycles si I' octet de poids faible du registre D 
(direct page register) est different de zero. 

TAX 

(Transfer Accumulator to index register X) 

Cette instruction transf^re les bits de I'accumulateur dans le registre 
d'index X. Le contenu de I'accumulateur ne varie pas. II y a 4 possibi- 
lites puisque I'accumulateur et le registre d'index X peuvent etre de 
tailles differentes: 

1) Registre d'index X en 8 bits «& Accumulateur en 8 bits : 

Les 8 bits de I'accumulateur sent transferes dans le registre d'index X 

2) Registre d'index X en 16 bits & Accumulateur en 8 bits (X=0 ; M=l): 
Les 8 pits du registre A de I'accumulateur sont transferes dans les bits 
de poids faible du registre d'index X. Les 8 bits caches du registre B de 
I'accumulateur deviennent les bits de poids fort du registre d'index. 

3) Registre d'index X en 8 bits & Accumulateur en 16 bits (X=l ; M=0): 
Seuls les 8 bits de poids faible (A) de I'accumulateur sont transferes 
dans le registre d'index. 

4) Registre d'index en 16 bits & Accumulateur en 16 bits (X=0 ; M=0): 
Les 16 bits de I'accumulateur (A+B) sont transferes dans le registre 
d'index X. 

Fonction : X < — A 

Modification des registres : 



Registre d'etat N V M X D I Z 

duprocesseur I ..... I 

Registre Ace X Y Mem 

/ 
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Modes d'adressage 



Syntaxe 



Code Octet Cycle 



Implicite 



TAX 



AA 



1 



TAY 

(Transfer Accumulator to index register Y) 

Cette instruction transf^re les bits de I'accuniulateur dans le registre 
d'index Y. Le contenu de I'accunnulateur ne varie pas. 
II y a 4 possiblites puisque I'accumulateur et le registre d'index Y 
peuvent §tre de tallies diff^rentes: 

1) Registre d'index Y en 8 bits & Accumulateur en 8 bits : 

Les 8bits de I'accumulateur sont transferes dans le registre d'index Y 

2) Registre d'index Y en 16 bits & Accumulateur en 8 bits (X=0 ; M=l): 
Les 8 bits du registre A de I'accumulateur sont transferes dans les bits 
de poids f aible du registre d'index Y. Les 8 bits caches du registre B de 
I'accumulateur deviennent les bits de poids fort du registre d'index. 

§) Segistre d'index ¥ en § bits & Accumulateur eh 16 bits (X=i ; M=6): 
Seuls les 8 bits de poids faible(A) de I'accumulateur sont transferes 
dans le registre d'index. 

4) Registre d'index en 16 bits & Accumulateur en 16 bits (X=0 ; M=0): 
Les 16 bits de I'accumulateur (A+B) sont transferes dans le registre 
d'index Y. 

Fonction : Y < — A 



Modification des registres : 



Registre d'etat 
du processeur 

Registre 



N 
/ 

Ace 



M 


X 


D 


I 


Z 

/ 


Y 


Mem 








/ 


. 









c 
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Modes d'adressage 


Syntaxe 


Code 


Octet 


Cycle 


Implicite 


TAY 


A8 


1 


2 



TCD 

(Transfer 16 bit accumulator to Direct page register) 

Cette instruction transfere les 16 bits de I'accumulateur (A+B) dans le 
registre direct D. Le contenu de I'accumulateur ne varie pas. 
Si Y'accumulateur est en mode 8 bits (microprocesseur, les bits caches 
de I'accumulateur (B) sont quand meme transf^res dans le registre 
direct D. 

Fonction : D < — C 



Modification des registres 



Registre d'6tat 
du processeur 

Registre 



N 
/ 

Ace 



V 



M 



X 



D 



Y Mem 



Z 

/ 



Modes d'adressage 



Syntaxe 



Code Octet Cycle 



Implicite 



TCD 



5B 



1 



TCS 

(Transfer C accumulator to Stack pointer) 

Cette instruction transf^re les 16 bits de I'accumulateur dans le 
registre du pointeur de pile S. Le contenu de I'accumulateur ne varie 
pas.Cette instruction est la seule avec TCS qui modifie le pointeur de 
pile. 
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Fonction : S < — C 



Modification des registres 



Registre d'etat 
du processeur 

Registre 



N 



V 



Ace X 



M 



Y Mem 



D 



Modes d'adressage 


Syntaxe 


Code 


Octet 


Cycle 


Implicite 


TCS 


IB 


1 


2 



TDC 

(Transfer Direct page register to 16 bit accumulator) 

Cette instruction transfere les 16 bits du registre direct D dans I'accu- 
mulateur m§me si celui ci est en mode 8 bits (les 8 bits sont transferes 
dans la partie B de I'accumulateur qui reste cependant occulte). Le 
contenu du registre direct D ne varie pas. 

Fonction : C < — D 



Modification des registres : 





Registre d'etat N V 
du processeur / 

Registre Ace X 

/ 


M 
Y 


X 

Mem 


D 


I Z C 

/ 










Modes d'adressage 




Syntaxe 


Code Octet 


Cycle 


Implicite 




TDC 


73 1 


2 
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TRB 

(Test and Reset memory Bits against accumulator) 



Cette instruction n'a^it que sur le banc et op^re k partir d'un masque. 
Elle effectue un test bit k bit entre I'accumulateur et I'adresse sp^cin^e. 
Le r^sultat de ce test est stocks dans I'operande en m^moire. Tout bit 
etant k 1 dans I'accumulateur sera mis k dans I'operande en m& 
moire. 

Fonction : M < — M '^ A 



Modification des registres : 



Registre d'etat 
du processeur 

Registre 


N 
Ace 


V 
X 


M X D 

Y Mem 
/ 


I Z 

/ 


C 






Modes d'adressage 




Syntaxe 


Code 


Octet 


Cycle 


Absolu 
Direct 






TRB addr 
1 KB dp 


IC 

14 


3 
2 


6*(1) 
5 *(1,2) 



pour k cakul du nombr§ dc cycks i 

1 = ajouter 1 au nombre de cycles si M=0. 

2 = ajouter 1 au nombre de cycks si ks bits de poidsfaibk du registre D sont 
differents de zero. 



90 
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TSB 

(Test and Set memory Bits against accumulator) 



Cette instruction n' a^t aue sur le banc et op^re a partir d'un masque. 
Elle ef f ectue un test bit k bit entre 1' accumulateur et 1' adresse sp^cifiee. 
Le resultat de ce test est stocks dans I'operande en memoire. Tout bit 
^tant h 1 dans 1' accumulateur sera mis h 1 dans I'operande en me- 
moire. 



Fonction : M < — M V A 

Modification des registres : 








Registre d'etat N 
du processeur 

Registre Ace 


V M 
X Y 


X D 

Mem 
/ 


I Z 

/ 


C 




Modes d'adressage 


Syntaxe 


Code 


Octet 


Cycle 


Absolu 
Direct 


TB addr 
TSBdp 


OC 
04 


3 
2 


6*(1) 
5 *(1,2) 



pour le calcul du nombre de cycles : 

(1) = ajouter 1 au nombre de cycles si M=0 

(2) = ajouter 1 au nombre de cycles si I' octet de poids faible du registre D 
(direct page register) est different de zero. 

TSC 

(Transfer Stack pointer to 16 bit accumulator) 

Cette instruction transf^re les 16 bits du pointeur de pile dans I'accu- 
mulateur. Le contenu du pointeur de pile S ne varie pas. 
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Fonction : C < — S 



Modification des registres 



Registre d'etat N V M X D 
du processeur / . . . ♦ 


I Z C 
/ 


Registre Ace X Y Mem 





Modes d'adressage 


Syntaxe 


Code 


Octet 


Cycle 


Implicite 


TSC 


3B 


1 


2 



TSX 

(Transfer Stack pointer to index register X) 



Le contenu du registre d'index X est transfere dans le pointeur de pile 
S (Stack pointer). Le contenu de X ne varie pas. 

II y a 2 possibilites : 

1 ) Le registre d'index X est en 8 bits (X= 1 ) ; seuls les bits de poids f aible 
du pointeur de pile S sont transferes dans le registre d'index X. 

2) Le registre d'index X est en 16 bits (X=0) ; la totalite des 16 bits du 
pointeur de pile sont transferes dans le registre d'index X 

Fonction : X < — S 



Modification des registres : 



92 



Registre d'etat 
du processeur 

Registre 


N 


V 


M 


X 


D 


I Z 


C 


/ 
Ace 


X 
/ 


Y 


Mem 




/ 
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Modes d'adressage Syntaxe Code Octet Cycle 



Implicite TSX BA 



TXA 

(Transfer index register X to Accumulator) 

Transfert de X dans A 

Cette instruction transfere le registre d'index X dans I'accumulateur 

Le registre d'index X lui ne change pas. 

II y a 4 possibilites puisque I'accumulateur et le registre d'index X 
peuvent etre de tallies differentes : 

1) Redstre d'index X en 8 bits & Accumulateur en 8 bits : 

Les 8 bits du registre d'index X sont transferes dans I'accumulateur 

2) Registre d'index X en 16 bits & Accumulateur en 8 bits (X=0 ; M=l): 
Seu s les 8 bits de poids faible du registre d'index X sont transforms. 
Seule la partie A de I'accumulateur est affectee par cette operation. La 
partie B de I'accumulateur ne change pas. 

3) Registre d'index X en 8 bits & Accumulateur en 16 bits (X=l ; M=0)- 
Les 8 bits du registre d'index X sont transferes dans la partie A de 
1 accumulateur. La partie B de I'accumulateur est mise k Zero. 

4) Registre d'index en 16 bits & Accumulateur en 16 bits (X=0 ; M=0): 
Les 16 bits du registre X sont transferes dans I'accumulateur. 
Fonction : A < — X 

Modification des registres : 



Registre d'etat 
dupF5e6§§eUf 


N 
/ 


V 


M X 








D 


I Z 

/ 


C 


Registre 


Ace 


X 


Y Mem 










/ 
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Modes d'adressage 


Syntaxe 


Code 


Octet 


Cycle 


Implicite 


TXA 


8A 


1 


2 



TXS 

(Transfer index register X to Stack pointer) 

Le contenu du registre d'index X est transfere dans le pointeur de pile 
S (Stack pointer). Le contenu de X ne varie pas. Cette instruction est 
la seule avec TCS qui modifie le pointeur de pile. 

II y a 3 possibilit^s : 

1) En mode Emulation (E=l) : Le pointeur de pile a seulement 8 bits, 
et le registre X ^galement. Les 8 bits contenus dans le registre d'index 
X sont transf^res. 

2) Le registre X est en mode 8 bits mais le 65C816 est en mode natif 
(X=l) : Les 8 bits du registre X sont transfer's dans les bits de poids 
faible du pointeur de pile. Les bits de poids fort du pointeur de pile 
sont mis a zero. 

3) Le registre X est en mode 16 bits et le 65C816 est en mode natif 
(X=0) . 

Tous les 16 bits du registre d'index X sont transf'res dans le pointeur 
de pile. 

Fonction : S < — X 



Modification des registres : 



Registre d'etat 
du processeur 

Registre 



N 


V 


M 


X 


D 


I 


Z 


C 


• 


• 


• 












Ace 


X 


Y 


Mem 
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Modes d'adressage 



Syntaxe 



Code Octet Cycle 



Implicite 



TXS 



9A 



1 



TXY 

(Transfer index register X to Y) 

Cette instruction transfere les bits du registre d'index X dans le 
registre d'index Y. Le registre d'index X lui ne change pas. Ces deux 
operations peuvent etre effectuees dans les deux modes 8 bits (X=l) 
et 16 bits (X=0). Comme les deux registres ne sont jamais de tallies 
differentes, cette operation ne pose aucun probl^me. 

Fonction : Y <— X 



Modification des registres : 



Registre d'etat 


N 


V 
X 


M 

Y 

/ 


X 

Mem 


D 


1 


Z 

/ 


C 


du processeur 


/ 


Registre 


Ace 







Modes d'adressage 



Syntaxe 



Code Octet Cycle 



Implicite 



TXY 



9B 



1 



TYA 

(Transfer index register Y to Accumulator) 



Cette instruction transffere le registre d'index Y dans I'accumulateur. 
Le registre d'index Y lui ne change pas. 

II y a 4 possiblites puisgue I'accumulateur et le registre d'index Y 
peuvent etre de tallies differentes : 
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1) Registre d'index Y - 8 bits & Accumulateur - 8 bits : 

Les 8 Dits du registre d'index Y sont transferes dans I'accumulateur. 

2) Registre d'index Y en 16 bits & Accumulateur en 8 bits (X=0 ; M=l): 
Seuls les 8 bits de poids faible du registre d'index Y sont transferes. 
Seule la partie A de I'accumulateur est affectee par cette operation. La 
partie B de I'accumulateur ne change pas. 

3) Registre d'index Y en 8 bits & Accumulateur en 16 bits (X=l ; M=0): 
Les 8 bits du registre d'index Y sont transferes dans la partie A de 
I'accumulateur. La partie B de I'accumulateur est mise h z^ro. 

4) Registre d'index en 16 bits & Accumulateur en 16 bits (X=0 ; M=0): 
Les 16 bits du registre Y sont transferes dans I'accumulateur. 

Fonction : A < — Y 

Modification des registres : 



Registre d'etat 
du proccsseur 


N 
/ 


V 


M 


X 


D 


I Z 
/ 


C 


Registre 


Ace 

/ 


X 


Y 


Mem 









Modes d'adressage 


Syntaxe 


Code 


Octet 


Cycle 


Implicite 


TYA 


98 


1 


2 



TYX 

(Transfer index register Y to X) 



Cette instruction transf^re le registre d'index Y dans le registre d'in- 
dex X. Le registre d'index Y lui ne change pas. Ces deux operations 
peuvent etre effectuees dans les deux modes 8 bits (X=l) et 16 bits 
(X=0). Comme les deux registres ne sont jamais de tallies differentes, 
cette operation ne pose aucun probl^me. 
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Fonction : X < — Y 

Modification des regis tres : 



Registre d'etat 
du processeur 

Registre 


N 
/ 

Ace 


V 

X 
/ 


M 
Y 


X D 
Mem 


I Z C 

/ 


lllllllllll 








Modes d 


'adressage 




Syntaxe 


Code Octet 


Cycle 


Implicite 






TYX 


BB 1 


2 



WAI 

(WAit for Interrupt) 

Attente d'une interruption. Le microprocesseur arrete toute opera- 
tion iusqu'^ ce qu'intervienne une interruption hardware externe 
(NMI - ABORT -^SET - IRQ). 
Fonction : Ready < — 



Modification des registres : 



Registre d'etat 
du prcxesscur 

Registre 



N 



Ace 



M 



Y Mem 



D 



Modes d'adressage 


Syntaxe 


Code 


Octet 


Cycle 


Implicite 


WAI 


CB 


1 


3 



copyright Toolbox 1 990 97 



WDM 



(William D. Mensch, jr) i 



Cette instruction a et6 r^servee par Mr. Williams D. Mensch, Jr, le 
concepteur du 65C816 chez Western Design Center, afin d'accroitre 
plus tard les possibilit^s du 65C816. 

Fonction : / 

Modification des registres : 



i 



Registre d'etat N V M X D I Z C 

du processeur . ....... 

Registre Ace X Y Mem 



Modes d'adressage 


Syntaxe 


Code 


Octet 


Cycle 


Implicite 


WDM 


42 


? 


7 



XBA 

(exchange B and A accumalators) 

Comme nous I'avons vu dans la partie sur I'accumulateur, ce dernier 
est eempasi de 2 r§gi§tf g§ A et B. C@tt@ instf uetion pgrmet d'lchangef 
les bits de A avec ceux de B. 

Fonction : A < — > B 

Modification des registres : 



Registre d'etat 
du prcKesseur 

Registre 


N 
/ 

Ace 
/ 


V 


M X 1 


D 


I Z 

/ 


C ::i;::;i|:ii||i| 


X 


Y Mem 
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Modes d'adressage 



Syntaxe 



Code Octet Cycle 



Implicite 



XBA 



EB 



XCE 

(exchange Carry and Emulation bits) 

Cette instruction sert k echanger dans le registre d'etat du processeur 
le bit de la retenue (carry) et le bit d'emulation E. En programmation 
on se servira de cette instruction pour passer en 65C02 ou en 65C816, 
suivant que Ton est dans un mode ou dans I'autre. 

Fonction : X < — > E 



Modification des registres : 



Registre d'etat 
du processeur 


N 


V 


M 
/ 


X 

/ 


D 


I Z 


C 
/ 


Registre 


IsAcc 


X 

/ 


Y 
/ 


Mem 









Modes d'adressage 



Implicite 



Syntaxe 



XCE 



Code Octet Cycle 



FB 



1 



i^i. 
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1.2 Le tableau suivant vous donnera la liste des instructions par 
code hexadecimal croissant. 



Mode d'adressage 

Pile 

Direct indirect indexe par X 

Pile 

Relatif h la pile 

Direct 

Direct 

Direct 

Direct indirect long 

Pile 

Immediat 

Accumulateur 

Pile 

Absolu 

Absolu 

Absolu 

Absolu long 

Relatif 

Direct indirect indexe par Y 

Direct indirect 

Relatif h la pile indirect indexe par Y 

Direct 

Direct indexe par X 

Direct indexe par X 

Direct indirect long indexe par Y 

Implicite 

Absolu indexe par Y 

Accumulateur 

Implicite 

Absolu 

Absolu indexe par X 

Absolu indexe par X 

Absolu long indexe par X 

Absolu 

Direct Indexe indirect 

Absolu long 

Pile relative 

Direct 

Direct 

Direct 

Direct indirect long 

Pile 



Code 




Hexa 


Mnemonique 


00 


BRK 


01 


ORA 


02 


COP 


03 


ORA 


04 


TSB 


05 


ORA 


06 


ASL 


07 


ORA 


08 


PHP 


09 


ORA 


OA 


ASL 


OB 


PHD 


OC 


TSB 


OD 


ORA 


OE 


ASL 


OF 


ORA 


10 


BPL 


11 


ORA 


12 


ORA 


13 


ORA 


14 


IRB 


15 


ORA 


16 


ASL 


17 


ORA 


18 


CLC 


19 


ORA 


lA 


INC 


IB 


TCS 


IC 


TRB 


ID 


ORA 


IE 


ASL 


IF 


ORA 


20 


JSR 


21 


AND 


?? 


JSR 


23 


AND 


24 


BIT 


25 


AND 


26 


ROL 


27 


AND 


28 


PLP 
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Code 




Hexa 


Mnemonique 


29 


AND 


2A 


ROL 


2B 


PLD 


2C 


BIT 


2D 


AND 


2E 


ROL 


2F 


AND 


30 


BMI 


31 


AND 


32 


AND 


33 


AND 


34 


BIT 


35 


AND 


36 


ROL 


37 


AND 


38 


SEC 


39 


AND 


3A 


DEC 


50 


BVC 


51 


EOR 


52 


EOR 


53 


EOR 


54 


MVN 


55 


EOR 


56 


LSR 


57 


EOR 


58 


CLI 


59 


EOR 


5A 


PHY 


5B 


TCD 


5C 


JMP 


5D 


EOR 


5E 


LSR 


5F 


EOR 


60 


RTS 


61 


ADC 


62 


PER 


63 


ADC 


64 


STZ 


65 


ADC 


66 


ROR 


67 


ADC 


68 


PLA 



Mode d'adressage 

Immediat 

Accumulateur 

Pile 

Absolu 

Absolu 

Absolu 

Absolu long 

Relatif 

Direct indirect indexe par Y 

Direct indirect 

Pile relative indirect indexe 

Direct indexe par X 

Direct indexe par X 

Drect indexe par X 

Drect indirect long indexe par X 

Implicit 

Absolu indexe par Y 

Accumulateur 

Relatif 

Direct indirect indexe par Y 

Direct indirect 

Pile relative indirecte index^e 

Bloc de depart — > bloc de destination 

Direct indexe par X 

Direct indexe par X 

Direct indirect long indexe par Y 

Implicite 

Absolu indexe par Y 

Pile 

Implicite 

Absolu long 

Absolu indexe par X 

Absolu indexe par X 

Absolu long indexe par X 

Pile 

Direct indexe indirect 

Pile 

Pile relative 

Direct 

Direct 

Direct 

Direct indirect long 

Pile 



copyright Toolbox 1990 101 



Code 




Hexa 


Mnemonique 


29 


AND 


2A 


ROL 


2B 


PLD 


2C 


BIT 


2D 


AND 


2E 


ROL 


2F 


AND 


30 


BMI 


31 


AND 


32 


AND 


33 


AND 


34 


BIT 


35 


AND 


36 


ROL 


37 


AND 


38 


SEC 


39 


AND 


3A 


DEC 


50 


BVC 


51 


EOR 


52 


EOR 


53 


EOR 


54 


MVN 


55 


EOR 


56 


LSR 


57 


EOR 


58 


CLI 


59 


EOR 


5A 


PHY 


5B 


TCD 


5C 


JMP 


5D 


EOR 


5E 


LSR 


5F 


EOR 


60 


RTS 


61 


ADC 


62 


PER 


63 


ADC 


64 


STZ 


65 


ADC 


66 


ROR 


67 


ADC 


68 


PLA 



Mode d'adiessage 

Immediat 

Accumulateur 

Pile 

Absolu 

Absolu 

Absolu 

Absolu long 

Relatif 

Direct indirect indexe par Y 

Direct indirect 

Pile relative indirect indexe 

Direct indexe par X 

Direct indexe par X 

Drect indexe par X 

Drect indirect long indexe par X 

Implicit 

Absolu indexe par Y 

Accumulateur 

Relatif 

Direct indirect indexe par Y 

Direct indirect 

Pile relative indirecte indexee 

Bloc de depart — > bloc de destination 

Direct indexe par X 

Direct indexe par X 

Direct indirect long indexe par Y 

Implicite 

Absolu indexe par Y 

Pile 

Implicite 

Absolu long 

Absolu indexe par X 

Absolu indexe par X 

Absolu long indexe par X 

Pile 

Direct indexe indirect 

Pile 

Pile relative 

Direct 

Direct 

Direct 

Direct indirect long 

Pile 
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Code 






Hexa 


Mnemonique 


Mode d'adressage 


69 


ADC 


Immediat 


6A 


ROR 


Accumulateur 


6B 


RTL 


Pile 


6C 


JMP 


Absolu indirect 


6D 


ADC 


Absolu 


6E 


ROR 


Absolu 


6F 


ADC 


Absolu long 


70 


BVS 


Pile relative 


71 


ADC 


Direct indirect indexe par Y 


72 


ADC 


Direct indirect 


73 


ADC 


Pile relative indirecte indexee 


74 


STZ 


Direct indexe par X 


75 


ADC 


Direct indexe par X 


76 


ROR 


Direct indexe par X 


77 


ADC 


Direct indirect long indexe par X 


78 


SEX 


Implicite 


79 


ADC 


Absolu indexe par Y 


7A 


PLY 


Pile 


7B 


TDC 


Implicite 


7C 


JMP 


Absolu indexe indirect 


7U 


ADC 


Absolu indexe par X 


71i 


ROR 


Absolu indexe par X 
Absolu long indexe par X 


7F 


ADC 


80 


BRA 


Pile relative 


81 


STA 


Direct indexe indirect 


82 


BRL 


Relatiflong 


83 


STA 


Pile 


84 


STY/ 


Direct 


85 


STA 


Direct 


86 


STX 


Direct 


87 


STA 


Direct indirect long 


88 


DEY 


Implicite 


89 


BIT 


Immediat 


8A 


TXA 


Implicite 


8B 


PHB 


Pile 


8C 


SlY 


Absolu 


8D 


STA 


Absolu 


8E 


STX 


Absolu 


8F 


STA 


Absolu long 


90 


BCC 


Pile relative 


91 


STA 


Direct indirect indexe par Y 


92 


STA 


Direct indirect 


93 


STA 


Pile relative indirecte indexee 
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Code 




Hexa 


Mnemonique 


94 


STY 


95 


STA 


96 


STX 


97 


STA 


98 


TYA 


99 


STA 


9A 


TXS 


9B 


TXY 


9C 


STZ 


9D 


STA 


9E 


STZ 


9F 


STA 


AO 


LDY 


Al 


LDA 


A2 


LDX 


A3 


LDA 


A4 


LDY 


A5^" 


LDA 


A6 


LDX 


A7 


LDA 


A8 


TAY 


A9 


LDA 


AA 


TAX 


AB 


PLB 


AC 


LDY 


AD 


LDA 


AE 


LDX 


AF 


LDA 


BO 


BCS 


Bl 


LDA 


B2 


LDA 


B3 


LDA 


B4 


LDY 


B5 


LDA 


B6 


LDX 


B7 


LDA 


B8 


CLV 


B9 


LDA 


BA 


TSX 


BB 


TYX 


BC 


LDY 


BD 


LDA 


BE 


LDX 



Mode d'adressage 

Direct indexe par X 

Direct indexe par X 

Direct indexe par Y 

Direct indirect long indexe par Y 

Implicite 

Absolu indexe par Y 

Implicite 

Implicite 

Absolu 

Absolu indexe par X 

Absolu indexe par X 

Absolu long indexe par X 

Immediat 

Direct indexe indirect 

Immediat 

Pile relative 

Direct 

Direct 

Direct 

Direct indirect long 

Implicite 

Immediat 

Implicite 

Pile 

Absolu 

Absolu 

Absolu 

Absolu long 

Pile relative 

Direct indirect indexe par Y 

Direct indirect 

Pile relative indirecte indexee 

Direct indexe par X 

Direct indexe par X 

Direct indexe par Y 

Direct indirect long indexe par Y 

Implicite 

Absolu indexe par Y 

Implicite 

Implicite 

Absolu indexe par X 

Absolu indexe par X 

Absolu indexe par Y 
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ind 



Code 






Hexa 


Mnemonique 


Mode d'adressaj 


BF 


LDA 


Absolu long indexe par X 


CO 


CPY 


Imm^diat 


CI 


CMP 


Direct indexe indirect 


r? 


REP 


Immediat 


r3 


CMP 


Pile relative 


C4 


CPY 


Direct 


cs 


CMP 


Direct 


C6 


DEC 


Direct 


C7 


CMP 


Direct indirect long 


C8 


INY 


Implicite 


C9 


CMP 


Immediat 


CA 


DEX 


Implicite 


CB 


WAI 


Implicite 


CC/ 


CPY 


Absolu 


cp/ 


CMP 


Absolu 


ci 


DEC 


Absolu 


CF 


CMP 


Absolu long 


DC 


BNE 


Pile relative 


D1^ 


CMP 


Direct indirect indexe par Y 


D2 


CMP 


Direct indirect 


D3 


CMP 


Pile relative indirecte indexee 


D4 


PEI 


Pile 


D5 


CMP 


Direct indexe par X 


D6 


DEC 


Direct indexe par X 


D7 


CMP 


Direct indirect long indexe par Y 


D8 


CLD 


Implicite 


D9 


CMP 


Absolu indexe par Y 


DA 


PHX 


Pile 


DB 


SIP 


Implicite 


DC 


JMP 


Absolu indirect long 


DD 


CMP 


Absolu indexe par XP 


DE 


DEC 


Absolu indexe par X 
Absolu long indexe par X 


DF 


CMP 


EO 


CPX 


Immediat 


El 


SBC 


Direct indexe indirect 


E2 


SEP 


Immediat 


E3 


SBC 


Pile relative 


E4 


CPX 


Direct 


E5 


SBC 


Direct 


E6 


BMC 


Direct 


E7 


SBC 


Direct indirect long 


E8 


INX 


Implicite 


E9 


SBC 


Immediat 


EA 


NOP 


Implicite 


nrtfyjirno^^ T* 


tnThn-rlOOn 





Code 




Hexa 


Mnemonique 


EB 


XBA 


EC 


CPX 


ED 


SBC 


EE 


INC 


EF 


SBC 


FO 


BEQ 


Fl 


SBC 


F2 


SBC 


F3 


SBC 


F4 


PEA 


F5 


SBC 


F6 


INC 


F^ 


SBC 


F8 


SED 


F9 


SBC 


?A 


PLX 


FB 


XCE 


EC 


SR 


FD 


SBC 


FE 


INC 


FF 


SBC 



Mode d'adressage 

Implicite 

Absolu 

Absolu 

Absolu 

Absolu long 

Pile relative 

Direct indirect indexe par Y 

Direct indirect 

Pile relative indirecte indexee 

Pile 

Direct indexe par X 

Direct indexe par X 

Direct indirect long indexe par Y 

Implicite 

Absolu indexe par Y 

Pile 

Implicite 

Absolu indexe indirect 

Absolu indexe par X 

Absolu indexe par X 

Absolu long indexe par X 
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1.3 Les differents modes d'adressage. 

Les differents modes d'adressage caracterisent les possibilites d'acc^s 
du microprocesseur k I'information en memoire. 

1.3.1 Adressage implicite 

Cet adressage est aussi dit «adressage inherent» ou «adressage de 
registre». Les instructions impli cites n'ont pas d'operande et s'assem- 
blent en un seul octet. L'op^rande est en fait inherent au code - 
operation. Toute I'information necessaire h I'execution de I'instruc- 
tionestenfaitecontenuedansl'instructionetnenecessitepasd'adresse. 
Ce mode d'adressage conceme les instructions d'echan^e entre regis- 
tre tels que TAY, des instructions forgant des bits du registre d'etat du 
processeur tel que CLC, ou aux instructions de manipulations de la 
pile tel que PEA, ou aux retours de sous - programmes tel que RTS 

1.3.Z Adressage Immediat. 

Ce mode d'adressage consiste k mettre directement derri^re le code de 
I'operation la donnee sur laquelle on veut operer, et non une adresse. 

1.3.3 Adressage Accumulateur. 

Ce mode d'adressage conceme les instructions ne modifiant que 1' ac- 
cumulateur. Ces instructions sont les decalages, les rotations, I'incre- 
mentation ou la decrementation de I'accumulateur. 

1.3.4 Adressage absolu 

Le second et le troisi^me octet de I'instruction, en adressage absolu 
forment les 16 bits de poids faible de I'adresse effective. Le registre 
DBR (Data Bank register) contient les 8 bits de poid fort de I'adresse. 

1.3.5 Adressage absolu long 

Le second, troisi^meet quatri^me octets de I'instruction forment les 24 
bits de I'adresse effective. 

1.3.6 Adressage direct 

Le second octet de I'instruction est additionne avec le registre D 
(Registre Direct) pour former I'adresse effective. 
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1.3.7 Adressage direct indirect indexe par Y 

Ce mode d'adressage est aussi appelle «Indirect Y». Le second octet 
de I'instruction est additionne avec le contenu du registre D (Registre 
direct). Les 16 bits alors obtenus sont associes avec les bits du registre 
DBR pour former une adresse de 24 bits. A cette adresse de 24 bits il 
suffit d'additionner le contenu du registre d'index Y pour former 
I'adresse effective. 
/ 

1.3.8 Ad^ressage indirect long indexe par Y 

Le second octet de I'instruction est additionne au contenu du registre 
D (Registre direct). Les 24 bits ainsi obtenus sont additionnes au 
registre d'index Y pour obtenir I'adresse effective. 

1.3.9 Adressage direct indexd indirect 

Ce mode d'adressage est aussi appelle «lndirect X».Le second octet de 
I'instruction est additionne k la somme du registre D (Registre direct) 
et du registre d'index X. Le resultat constitue le les 16 bits de poids 
faible de I'adresse effective. Les 8 bits de poids fort sont constitues par 
les 8 bits du registre DBR (Data bank register). 

1.3.10 Adressage direct index^ par X. 

Le second octet de I'instruction est additionne avec la somme du 
registre D (Registre direct) et du registre d'index X. Les 16 bits ainsi 
obtenus forment I'adresse effective. 

1.3.11 Adressage direct indexe par Y. 

Le second octet de I'instruction est additionne avec la somme du 
registre D (Registre direct) et du registre d'index Y. Les 16 bits ainsi 
obtenus forment I'adresse effective. 

1.3.12 Adressage absolu indexe par X. 

Le second et le troisi^me octet de I'instruction sont additionnes au 
registre d'index X pour former les 16 bits de poids faible de I'adresse 
effective. Les 8 bits de poids fort sont contenus dans le registre DBR 
(Data bank register). 



1.3.13 Adressage absolu long indexe par X. 

Le second, troisi^me et quatri^me octet de I'ii 
bits de I'adresse de base. L'adresse effective 
nant cette adresse de base au registre d'index X. 



Le second, troisi^me et quatri^me octet de I'instruction forment les 24 
bits de I'adresse de base. L'adresse effective est obtenu en addition- 
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1.3.14 Adressage absolu index6 par Y. 

Le second et le troisi^me octet de 1' instruction sont additionn^s au 
registre d'index Y pour former les 16 bits de poids faible de I'adresse 
effective. Les 8 bits de poids fort sont contenus dans le registre DBR 
(Data bank register). 

1.3.15 Adressage relatif 

Ce mode d'adressage est utilise uniquement avec les branchements. 

Si la condition est remplie le second octet de instruction est addition- 

n6 au compteur ordinal, afin que la prochaine instruction puisse §tre 

executee. 

Le branchement ne peut s'eff ectue qu'en tre - 1 28 et + 1 27 octets h partir 

de I'instruction suivant le branchement. 

1.3.16 Adressage relatif long 

Ce mode d'adressage n'est utilise q^u'avec 2 instructions BRL et PER. 
Le second et le troisi^me octet de I'mstruction sont ajoutes au comp- 
teur ordinal, qui est situ6 une fois que cette instruction se deroule k 
I'instruction imm^diatement suivante de BRL ou de PER, pour for- 
mer I'adresse effective. 

1.3.17 Adressage absolu indirect. 

Le second et le troisi^me octet de I'instruction forment une adresse de 
16 bits. Le compteur ordinal est charge avec le premier et le second 
octet k cette adresse. 

1.3.18 Adressage direct indirect. 

Le second octet de I'instruction est ajoute au Registre D^our former 
les 16 bits de poids faible I'adresse effective. Le registre DBR contient 
les 8 bits de poids fort de I'adresse effective. 

1.3.19 Adressage indirect long. 

Le second octet de I'instruction est ajoute au registre D pour former 
les 24 bits de I'adresse effective. 

1.3.20 Adressage absolu indexe indirect. 

Le second et le troisi^me octet de I'instruction sont ajoutes au registre 
d'index X, pour former les 16 bits de I'adresse effective. 
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1.3.21 Pile 

Seules les instructions manipulant la pile utilisent ce type d'adressage. 
L'adresse du banc est toujours 0. 

1.3.22 Pile relative 

Les 16 bits de poids faible de l'adresse effective sont formes par la 
somme du second octet de 1' instruction et du pointeur de pile. Les bits 
de poids fort de l'adresse effective sont toujours 0. 

1.3.23 Pile relative indirect indexe. 

Le second octet de instruction est ajoute au registre pointeur de pile 

Eour former les 16 bits de poids faible de l'adresse de base. Le registre 
»BR contient les 8 bits de poids fort de l'adresse de base. On ajoute k 
cette adresse de base le contenu du registre Y, pour former l'adresse 
effective. 

1.3.24 emplacement de bloc memoire. 

Ce mode d'adressage n'est utilise que par les instructions de d^place- 
ment de bloc memoire. Le second octet de I'instruction contient les 8 
bits de poids fort de l'adresse de destination. Le registre d'index Y 
contient les 16 bits de poids faible de l'adresse de destination. 
Le troisi^me octet de 1 instruction contient les 8 bits de poids fort de 
l'adresse de depart. Le registre d'index X contient les 16bits de poids 
faible de l'adresse de depart. 
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1.4 Conclusion sur le microprocesseur. 

En conclusion sur le microprocesseur, je dirais que le 65C816 a 
I'avantage que ses instructions n'utilisent que peu de cycles, par 
rapport a d'autres microprocesseurs. 

On peut cependant regretter que le changement d'adressage ne puisse 
pas comprendre des incrementations h 2, ainsi qu'une auto incremen- 
tation du compteur ordinal entre deux bornes, notament pour les 
consultations ae tables. 

De plus, la longueur d'un cycle de ce microprocesseur peut varier 
dans le temps, ce qui peut etre g^nant dans certaines applications qui 
n^cessitent une synchronisation parfaite. 

Enfin mon plus grand regret est que le microprocesseur du GS n'est 
cadenc^ qu k 2.8 Mhz, alors qu'un minimum de BMhz semblerait ne- 
cessaire. 



110 copyright TooBiox 1990 



la RAM du GS 



2.0 Organisation 

La memoire du GS peut etre divisee en trois zones distinctes : 

•la memoire principale accessible directement au micro-processes- 



seur. 



•la memoire du DOC ( Ensoniq) Ram de 64k accessible directement 
par I'ensoniq et via une serie de Softswitches (commutateurs logi- 
ciels) par le micro-processesseur. 

•la memoire Cmos ( BRAM) sauvegardee par batterie et contenant la 
confiffuration du GS. (parametra^e du tableau de controle : Control 
PaneD- Cette memoire est geree directement par le circuit horloge, et 
accessible via une serie de Softswitches. 

La memoire principale est elle meme divisee en plusieurs zones : 

•La memoire rapide, 128k de base sur la carte mere. Cette zone 
memoire est composee des bancs $00 k $79. 

•La memoire lente, memoire syst^me k laquelle on accede k la vitesse 
de IMhz ( Vitesse lente). Cette zone memoire est composee de 128k 
formant les bancs $E0 k $E1. Dans cette zone est incluse la zone des 
entrees sorties de $C000 k $CFFF, ainsi que la memoire utilise par 
I'affichage vid^o. 
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2.1 L'eff et miroir ou shadowing 

Le GS poss^de done deux types de memoires fonctionnant k des 
vitesses diff^rentes. La presence d'une memoire accedee unique- 
ment k IMhz (vitesse lente) est necessaire pour les entrees sorties et 
I'affichage video. 

Mais la presence d'un mode emulation Apple II sur Gs implique cju'il 
est necessaire de tranf^rer des informations entre la memoire rapide, 
simulant les 64K de la memoire principale et les 64k de la memoire 
auxiliaire, vers la memoire lente contenant notamment les entrees 
sorties et la memoire vid6o (page texte, graphique ....) . E^oii la 
presence d'un m^canisme transferant automatiquement des valeurs 
^crites en certains emplacements de la memoire rapide vers les 
m§mes emplacements de la memoire lente. Ce mecanisme h. pour 
nom le Shadowing, ou effet Miroir. 

L'ef f et Miroir peut af fecter dif ferentes zones de la memoire des bancs 
$00 et $01. Ces zones sont les suivantes : 

0400-07FF Texte page 1 

2000-3FFF Page Hires 1 

4000-5FFF Page Hires 2 

2000-9FFF Super Hires 

2000-3FFF Page Hires memoire auxiliaire 

COOO-FFFF E / S et carte langage 

On remarque que la page Texte 2 ne peut pas beneficier de I'effet 
Miroir, on est done oblige de le simuler de facon logiciel par la copie 
periodique de la page 2 du bank $00 dans le bank $E0; cette option est 
valid^e via le tableau de controle (Alternate display mode). 

L'etat de I'effet Miroir est controle par le registre se trouvant en $C035 
(quagmire state). 

II s'a^it d'un registre d'un octet indiquant, outre la vitesse de la 
machme (lente /rapide) les zones memoires affectees par I'effet 
Miroir. 

II faut noter que I'utilisation de I'effet Miroir ralenti la machine. En 
effet, lors de chaq^ue acc^s en ^criture k une zone Refletee, la valeur 
ecrite est automatiquement reportee dans la zone correspond ante de 
la memoire lente. Ce ph^nomeme ne se produit evidemment pas lors 
des operations de lecture. 

De m§me une ecriture directe en $E0 ou $E1 ne gen^re pas une 
recopie de la valeur dans les bancs k vitesse rapide. L' effet Miroir ne 
marche que dans un sens memoire rapide vers memoire lente et 
seulement pour les operations d'ecriture. 
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2.1 La page zero 00/0000 - 00/OOFF 



Dans la page z^ro se trouve la plupart des variables utilisees en 
mode emulation, par I'applesoft, Prodos 8 et le moniteur. 
En mode GS/OS la memoire (dont la page zero, positionable dans 
une page quelconque du banc 0) est ger^ par le Gestionnaire de la 
memoire et aucune variable h emplacement fixe n'y est definie. 

Label 

$00 - $02 JMP $D43C entree a chaud de I'applesoft 

$03 - $05 JMP $DB3A STROUT 

$06 - $09 libre 

$0 A - $0C JMP adresse appelee par la f onction USR de 1' applesof t. 

$0D - $10 variables applesoft 

$11 VALTYP si FAC nombre 1 si chaine 

$12 - $13 variables applesoft 

$14 SUBFLAG si 00 variable dimensionnee $80 sinon 

$1 5 - $1 7 variables applesoft 

$18 - $1F libre 

$20 WNDLFT Colonne de debut de la fenetre 

$21 WNDWDTH Nombre de colonnes de la fenetre 

$22 WNDTOP premiere ligne de la fenetre 

$23 WNDBTM derni^re ligne de la fenetre 

$24 CHColonne du curseur 

$25 CV Ligne du curseur 

$26 - $27 GBASL Adresse du debut de la ligne 

GBASH courante dans la page Basse resolution 

calculee par GBASCALC 

Pointeur temporaire (DOS 3.3 RWTS) 
$28 - $29 BASL Adresse de debut de la ligne de texte 

BASH courante calculee par BASCALC Pointeur tem 

goraire (DOS 3.3) 
AS2L Pointeur ligne de destination lors BAS2H 
d'un scroll. 

Pointeur temporaire (DOS 3.3) 
$2C H2 Zone temporaire graphisme basse resolution 

LMNEN Zone temporaire decodage mnemoniques 
Mini assembleur 



nCCKK^XT , 



RTNL 

Checksum de I'entete du secteur (DOS 3.3 RWTS) 
$2D V2 Zone temporaire graphisme basse resolution 

RMNEM Zone temporaire decodage mnemoniques 
Mini assembleur 

RTNH Num^ro de secteur contenu dans I'entete (DOS 
3.3 RWTS) 
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$2E MASK Masque couleur pour graphismes basse reso- 

lution 

FORMAT Zone temporaire decodage de 

I'opcode Mini assembleur. Numero de piste contenu 

dans I'entete (DOS 3.3 RWTS) 
$2F LASTIN Utilise lors de la lecture 

cassette sur Apple He et II+. 

LENGTH Zone temporaire decodage de opcode Mini 

assembleur Num4ro de volume contenu dans 

I'entete (DOS 3.3 RWTS) 
$30 COLOR Couleur graphisme basse resolution 

$31 MODE Mode dans lequel se trouve le moniteur 

$32 INVFLG Masque utilise lors de I'affichage 

$3F : lettres en video inverse 

$FF : lettres normales 

$7F : lettres clignotantes 

Toute autre valeur donne un affichage incoherent. 
$33 PROMPT Caractere utilise comme prompt, est 

affich6 par la routine GETLIN : $FD6A 

$AA pour le moniteur code Ascii de * 

$DD pour I'applesoft en entree de ligne code Ascii de] 
$34-$35 YSAV Sauveearde YSAVl 
$35 Numero du drive dans le bit de poids fort 

(DOS 3.3 RWTS) $80 drive 1- $00 drive 
$36-$37 CSW Adresse de la routine de sortie de 

CSWH caracteres. 
$38-$39 KSW Adresse de la routine d'entree de 

KSWH caracteres. 

$3A-$4F Zone utilisee par PRODOS 

$3A-$3B PCL Sauvegarde du compteur programme 

PCH 
$3C-$3D Adresse du DCT (DOS 3.3 RWTS) 

Device characteristics table. 
$3E-$3F Adresse du buffer (DOS 3.3 RWTS) 
$40-$41 Adresse du buffer fichier (DOS 3.3) 
$41 Compteur de formatage (DOS 3.3 RWTS) 

$42-$43 Adresse d'un buffer de travail (DOS 3.3) 
$44-$45 OPerande numerique (DOS 3.3) 
$46-$47 Zone de travail (DOS 3.3 RWTS) 
$48-$49 Adresse de I'lOB (DOS 3.3 RWTS) 
$3C XQT Zone pour le pas a pas (Step) et la trace 

$3C-$45 AIL Zone des parametres pour 

AlH I'appel de sous programmes du 

A2L moniteur. 

A2H, A3L,A3H,A4L,A4H,A5L,A5H 

Exemple appel de la routine Auxmove 
$44-$49 Sauvegarde des registres apres un BRK 
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$46-$47 Zone de travail (DOS 3.3 RWTS) 

$48-$49 Adresse de I'lOB (DOS 3.3 RWTS) 

$44 MACCSTAT Etat de la machine apr^s un BRK 

$45 ACC Sauvegarde de raccumulateur 

$46 XREG Sauvegarde de X 

$47 YREG Sauvegarde de Y 

$48 STATUS Sauvegarde dy registre d'etat 

$49 SPNT Sauvegarde du pointeur de pile 

$42-$47 Param^tres du «DEVICE DRIVER» Prodos 8 

$42 Code de la commande : 

$00 Status 
$01 Lecture 
$02 Ecriture 
$03 Formatage 

$43 Numero de I'unite sous la forme 

DSSSOOOO 
D numero du drive 
SSS numero du slot 
exemple : 01100000 soit 
$40 Drive 1 slot 6. 

$44-$45 Zone destination ou source. 

$46-$47 Numero du bloc. 

$4A-$4D Utilise par prodos 

$4C-$4D HIMEM himem du basic (INTEGER) 

$4E-$4F Nombre aleatoire 

$50-$51 Applesoft : Numero de la ligne 

apr^s un LINGET $DA0C 
$52-$61 Variables utilisees par I'applesoft 
$62-$66 Nombre flottant 

$67-$68 TXTTAB Adresse du debut du programme basic 
$69-$6A LOMEM Adresse de debut de la zone 

des variables simples (entiers et reels) 
$6B-$6C ARYTAB Adresse de la fin de la zone 

des variables simples, debut de la zone des tableaux 
$6D-$6E STREND Adresse de debut de la zone 

libre fin des tableaux 
$6F-$70 FRETOP Adresse de debut de la zone 

des chaines et de la fin de la zone libre 
$71-$72 Reserve Applesoft 

$73-$74 HEMEM fm de la zone disponible pour I'applesoft 
$75-$76 CURLIN Numero de la ligne en cours d'execution 

$ffff si mode direct 



copyright Tooftor 1990 115 



$77-$78 OLDLIN Numero de la derniere ligne executee ou 
interompue 

$79-$7A OLDTXPTR Adresse utilisee par CONT pour continuer 
I'execution d'un programme basic interompu. 

$7B-$7C Numero de la ligne de 1' instruction DATA courante 

$7D-$7E Adresse de I'element h. lire dans cette ligne 

$7F-$80 $201 lors d'un INPUT sinon egal k la ligne de 
data lors d'un READ 

$81 -$82 Nom, en Ascii de la derniere variable utilisee 

$83-$84 VARPNT Adresse de la valeur ou longueur de chaine 
de la demidre variable utilisee 

$85-$86 FORPNT 

$87-$89 Utilise par 1' Applesoft 

$8A-$8E TEMP3 Registre flottant sur 5 octets 

$8F-$92 Utilise par 1' Applesoft 

$93-$97 TEMPI Registre flottant sur 5 octets 
$98-$9C TEMP2 Registre flottant sur 5 octets 
$9D-$A2 FAC Registre flottant sur 5 octets : Accumulateur 

$A3-$A4 

$A5-$AA ARG Registre flottant contient le 2^me argument des 
fonctions 

$AB-$AC STRGNl Adresse d'un chaine devant etre deplacee 
par MOVINS 

$AD-$AE STRGN2 

$AF-$BO PRGEND Adresse de la fin du programme 

$B1-$C8 CHRGET Sous programme pour obtenir le prochain 
caract^re du programme, s'auto patch en TXTPTR 

$B8-$B9 TXTPTR Adresse du dernier caract^re obtenu par 
CHRGET 
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$C9-$CD Nombre aleatoire flottant 

$CA-$CB START debut du programme basic (INTEGER) 

$CA-$CD VAREND fin des variables (INTEGER) 

$CE-$CF Libre 

$D0-$D5 Utilise par la haute resolution 

$D6 Flag autoexecution si different de 

$D7 Libre 

$D8-$D9 Numero de ligne (INTEGER) 

$D8 ERRFLG $80 si ONERR est actif 

$D9 RUNMOD $80 si en cours d'execution 

$DA-$DB ERRLIN numero de la ligne ou I'erreur a eu lieu 
$DC-$DD ERRPOS adresse du caract^re ou a eu lieu I'erreur 
$DE 

ERRNUM code de I'erreur 
$DF ERRSTR sauvegarde registre pointeur de pile 

$E0-$E2 Coordonnees du curseur HGR 

$E4 Code de la couleur HGR 

$E6 HP AG Numero de la page HGR active $20 page 1 $40 



page 2 
SC/'~" 



$E7 SCALE Echelle des formes 

$E8-$E9 Adresse de la table des formes 

$EA Zone utilisee par la haute resolution 

$EB-$EF Libre 

$F0 FIRST 

$F1 SPDBYT Vitesse d'affichage 1 correspond k speed = 255 

en basic, h speed = en general SPEED = X 

correspond k SPDBYT = 256-X 

$F2-$F3 Libre 

$F4-$F8 Utilise par I'applesoft pour les traitements 
ONERR 

$F9-$FF Libre 
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Note : toutes les adresses, pointeurs 
sont stockees sous la forme poids 
faible poids fort, par exemple si 
TXTTAB = $801 en $67 on trouvera $01 
et en $68 $08 



.2 00/0100-00/03FF 

$100-$1FF Pile du 65C816 en mode emulation 

$200-$2FF Buffer d'entree de ligne sous 

basic pour GETLN 

$300-$3CF Libre 

$3D0-$3D2 WARM un saut (JMP) k I'entree k chaud du DOS 
Cette routine relance le Dos mais n' efface pas 
le programme basic en memoire et ne change pas 
Maxfile. (DOS 3.3) 

$3D3-$3D5 COLD un saut (JMP) vers I'entree k froid du DOS 
Reinitialise le dos, remet HIMEM k sa valeur 
initiale, supprime le programme Basic de la 
memoire. (DOS 3.3) 

$3D6-$3D8 Appel du file manager (DOS 3.3) 

$3D9-$3DB Appel de la RWTS (DOS 3.3) 
(Read / Write /Track / Sector 
ou lecture ecriture de pistes Secteurs) 

$3DC-$3E2 Localise la liste de param^tres du file manager 
Adresse dans A et V A contenant le poids fort. 

$3E3-$3E9 Localise 1' lOB utilisee pour les appels k la RWTS 

Adresse retournee dans A et Y poids fort dans A 

$3EA-$3EC Un saut vers la routine reconnectant le Dos 

aux vecteurs entree clavier sortie 6cran (DOS 3.3) 

$3F0-$3F1 BRKV adresse de la routine traitant les interruptions 

BRK. Normalement OLDBRK soit $FA59, routine 
affichant les registres. 

$3F2-$3F3 SOFTEV Adresse de la routine traitant le reset. 

$3F4 PWREDUP Valide 1' adresse du reset si cette valeur 6gale 
(SOFTEV+1) FOR $A5 
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Example de revectorisation du Reset : 

LDA #$59 ; poids faible ; de $FF59 soit ; OLDEST 

STA $3F2 ; SOFTEV 

LDA #$F ; poids fort de ; $FF59 

STA $3F3 ; SOFTEV+1 

JSR $FB6F ; SETPWRC routine 

du moniteur 

effectuant le 

FOR $A5 

$3F5-$3F7AMPERV Routine traitant I'ampersand 
en APPLESOFT. 
Normalement $3F5 contient $4C pour I'instruction JMP 

$3F8-$3F AUSRADR Routine traitant CTRL-Y pour le moniteur et 
la fonction USR pour I'applesoft 
Normalement on trouve un JMP $FF65 (MON) dans le 
moniteur, si basic, system k ete charge pointe 
sur I'entree k chaud du basic. 

$3FB-$3F DNMI Routine traitant les NML Normalement on 

trouve un $4C en $3FB (opcode de JMP) 
Normalement JMP $FF59 soit le OLDRST du moniteur 

$3FE-$3F nRQLOC Adresse de la routine traitant les IRQs. 
Normalement $ff65 

2.3 Carte Memoire Applesoft 

Zones occupees par I'Applesoft en mode emulation. 

TXTTAB $67-$68 

TEXTE 

DU 

PROGRAMME 

BASIC 
PRGEND $AF-$BO 

LOMEM $69-$6A 

VARIABLES SIMPLES 

ENTIERS REELS 
ARYTAB $6B-$6C 

TABLEAUX 
STREND $6D-$6E 

ZONE LIBRE 
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FRETOP $6F-$70 

CHAINES DE 
CARACTERES 

HIMEM $73-$74 

DOS ou PRODOS 



2.4 Occupation des bancs $EO - $E1 

Dans ces bancs, composes de memoire accedee h IMhz, se trouve la 

plupart des vecteurs du GS. 

De meme on y trouve les buffers video, et la zone des entrees sortie. 

2.4.1 Occupation du bank $E0 
$0000-$02FF Reserve. 

$0300-$03FF Buffer des accessoires de bureau. 

$0400-$07FF Texte page 1 . 

$0800-$0BFF Texte page 2. 

$0C00-$1DFF Buffer des accessoires de bureau. 
$1E00-$1FFF Vecteurs Quickdraw II. 

$2000-$3FFF Page graphique 1 . 

$4000-$5FFF Pa^e graphique 2. 

$6000-$BFFF Memoire libre geree par le gestionnaire memoire. 

$COOO-$CFFF Zone des entrees sorties 

$DOOO-$DFFF Buffers AppleTalk 

$EOOO-$FFFF ou loader Prodos 

2.4.2 Occupation du banc $E1 

2A.2.1Vecteurs du banc $E1 

$0000-$0003 DISPATCHl : 

Saut au «TOOL LOCATOR» localisateur d'Outils 
Normalement sous la forme JML$xx/xxxxx Type 1 
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$0004-$0007 
$0008-$000B 

$OOOC-$OOOF 

$0010-$0013 

$0014-$0017 

$0018-$001B 

$001C-$001F 



DISPATCH2 : 

Idem DISPATCHl mais pour tcx)ls type 2 

UDISPATCHl : 

copie de DISPATCHl modifiable pour installer sa 

propre version de tool locator type 1 

UDISPATCH2 : 

copie de DISPATCH2 modifiable pour installer sa 

propre version de tool locator type 2 

INTMGRV : 

Saut vers le gestionnaire d'interruption. Instruction 

jump long JML $xx/xxxx 

COPMGRV : 

Saut vers le gestionnaire des instructions COP. Ins- 
truction jump long JML $xx/xxxx 

ABORTMGRV : 

Saut vers le gestionnaire de ABORT. Actuellement 

traite comme le break affichage des registres. 

SYSDMGRV : 

Saut vers le gestionaire d'echec syst^me 

«system failure» L'appel de cette routine suppose 

I'etat suivant : 

. On doit se trouver en mode 16 bit natif 

. le bit carry doit etre ^ si I'adresse d'un message 
personnalise se trouve sur la pile sinon. 



. La pile contient les param^tres suivants : 

Code erreur poids fort 9,S 

Code erreur poids faible 8,S 7,S 

Num^ro de la bank de 

I'adresse du message 

Poids fort de I'adresse 

du message 

Poids faible de 

I'adresse du message 

Adresse de retour 

initulis^e 

Adresse de retour 

inutilisee 

Adresse de retour 

inutilisee 1,S 



8,S 
6,S 

5,S 

4,S 



3,S 
2,S 
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$0020-$0023 
$0024-$0027 
$0028-$002B 

$002C-$002F 

$0030-$0033 

$0034-$0037 
$0038-$003B 

$003C-$003F 



$0040-$0043 



$0044-$0047 



IRQ.APTALK : 

Saut vers le gestionnaire d' interruption Appletalk 

IRQ.SERIAL : 

Saut vers le gestionnaire d'interruption port serie 

IRQ.SCAN : 

Saut vers le gestionnaire d'interuption de fin de 

ligne «scan line interrupt* 

IRQ.SOUND : 

Saut vers le gestionnaire d'interruption processeur 

sonore 

IRQ.VBL : 

Saut vers le gestionnaire d'interruption de balayage 

vertical. 

IRQ.MOUSE 

Saut vers le gestionnaire d'interruption souris. 

IRQ.QTR : 

Saut vers le gestionnaire d'interruption quart de 

seconde. Utilise par AppleTalk 

IRQ.KBD : 

Saut vers le gestionnaire d'interruption du clavier. 
Actuellement le clavier negen^re pas d'interruption. 
II est possible de simuler leur presence par I'inter- 
mediaire du Miscellanous Tool set en installant une 
tache «hearbeat» (fonction SetHeartBeat) generant 
une interruption lors de la scrutation du clavier par 
le VBL. Si une touche est enfoncee la tache «heart 
beat» appelera cette routine via un JSL. 

IRQ.RESPONSE : 

Saut vers le gestionnaire d'interruptions reponse 
ADB Saut vers le gestionnaire de reponse de 1' Apple 
Desktop Bus. 

IRQ.SRQ : 

Saut vers le gestionnaire d'interruptions SRQ Saut 
vers le §;estionnaire des interruptions SRQ (Requette 
de service) de I'ADB (Apple Desk Bus) 
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$0048-$004B 



$004C-$004F 



$0050-$0053 



$0054-$0057 
$0058-$005B 



$005C-$005F 

$0060-$0063 
$0064-$0067 



IRQ.DSKACC : 

Saut vers le gestionnaire d'interruptions d'accds au 
gestionnaire de bureau. Saut vers la routine invo- 
quee lors de la pressioix des touches CTRL- POMME- 
ESC . En installant un RTL ($6B) k la place du JML 
($5C) on interdit I'acc^s au panneau de controle et 
aux CDA. 

IRQ.FLUSH : 

Saut vers le gestionnaire d'interruptions vidange 
du clavier. Cette interruption est provoquee par la 
frappe des touches CTRL-POMME-BACKSPACE 

IRQ.MICRO : 

Saut vers le gestionnaire d'interruptions d' abort du 

micro processeur clavier. Cette interruption a lieu 

lors d'une defaillance critique du microprocesseur 

du clavier. Si une telle erreur apparait le gestion 

naire essaye de resynchroniser et de reinitialiser le 

microprocesseur. 

IRQ.ISEC : 

Saut vers le gestionnaire d'interruption seconde. 

IRQ.EXT : 

Saut vers le gestionnaire d'interruptions VGC Nor- 
malement saut vers le gestionnaire des interrup- 
tions generees par le Video Graphic Chip ( circuit 
video). Actuellement la patte du circuit generant 
cette inter ruption est forcee h I'etat haut empe- 
chant toutes mterruptions. 

IRQ.OTHER : 

Saut vers le gestionnaire des autres interruptions. 
Ce gestionnaire traite toutes les interruptions non 
traitees par ailleurs par le logiciel. 

CUPDATE : 

Saut vers la routine de mise h jour du curseur 

dans QuickDraw II (Cursor Update) 

INCBUSYFLG : 

Saut vers la routine d'incrementation du flag oc- 

cupe. 
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$0068-$006B 



$006C-$006F 



$0070-$0073 



DECBUSYFLG : 

Saut vers la routine de decrementation du flag oc- 

cupe. 

BELLVECTOR : 

Saut vers une routine «personnelle» de BEEP. 

Cette routine est appellee par le moniteur k cha- 

que demande d'impression d'un caract^re $87 via 

les vecteurs de sortie (CSWL/CSWH $36/$37) et 

lors de I'appel des routines BELLI BELLI. 2 et 

BELL2 ($FBDD, $FBE2, $FBE4). 

La routine doit satisfaire aux caracteristiques 

suivantes : 

•EUeestappelee en mode Sbit natif et doit revenir 

au moniteur en mode Sbit natif. 

•Les registres Data Bank et Direct doivent etre 

preserves. 

•Le bit carry doit etre h zero (clear) ou le moniteur 

g^nerera son propre beep. 

•Le registre X doit etre preserve. 

•A la sortie de la routine Y doit contenir 

BREAKVECTOR : 

Saut vers une routine «personnelle» de traitement 
de I'opcode BRK. Cette routine doit obeir au caracte- 
ristiques suivantes : 

•EUe est appellee en mode Sbit natif, vitesse ra- 
pide, avec le registre Data Bank egal h zero et le 
registre Direct egal h zero. 

•La valeur des registres Data Bank et Direct doit etre 
preservee. 

•La routine doit se terminer par un RTL et revenir 
en mode 8 bit natif vitesse rapide. 
•Le bit carry doit etre k zero au retour de cette 
routine sinon le moniteur appelle la routine pointee 
par$00/$3F0-$3Fl. 

Si le bit carry est k zero le programme interrompu 
par le BRK est poursuivi 2 octets apr^s le BRK. 
Ce vecteur est prevu a I'usage des logiciels de de- 
boguage. 
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$0074-$0077 TRACEVECTOR : 

Saut vers la routine de trace. Cette routine doit obeir 
aux caracteristiques suivantes : 
•EUe est appelee en mode 8 bit natif, vitesse rapide, 
avec le registre Data Bank egal h zero et le registre 
Direct egal h zero, 

•La valeur des registres Data Bank et Direct doit etre 
pr^servee. 

•La routine doil se terminer par un RTL et revenir 
en mode 8 bit natif vitesse rapide. 
•Le bit carry doit etre k zero au retour de cette 
routine sinon le moniteur appelle la routine point^e 
par$00/$3F0-$3Fl. 

Si le bit carry est a zero lors du retour de la routine 
usager, le programme interompu est continue, sinon 
le message Trace est affiche sur I'ecran avant conti- 
nuation du programme. Ce vecteur est prevu k 
I'usage des logiciels de deboguage. 

$0078-$007B STEPVECTOR : 

Vecteur step. Cette routine doit obeir aux caracte- 
ristiques suivantes : 

•EUe est appelee en mode 8 bit natif, vitesse rapide, 
avec le registre Data Bank egal k zero et Le registre 
Direct egal k zero, 

•La valeur des registres Data Bank et Direct doit etre 
preservee. 

•La routine doit se terminer par un RTL et revenir 
en mode 8 bit natif vitesse rapide. 
•Le bit carry doit etre k zero au retour de cette rou- 
tine sinon le moniteur appelle la routine pointee par 
$00/$3F0-$3Fl . Si le bit carry est k zero lors du retour 
de la routine usager, le programme interrompu est 
continue, sinon le message Step est affiche sur 
I'ecran avant continuation du programme. Ce vec- 
teur est prevu k I'usage des logiciels de deboguage. 

$007C-$007F Reserve pour des extensions futures. 

L'adresse de ces vecteurs estgarantie pour toutes les versions des systbnes 
d' exploitation de V Apple II GS. Ces vecteurs ne doivent en aucun cos etre 
alter es par une application. 
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$0080-$0083 TOWRITEBR : 

Vecteur sur la routine d'ecriture dans la BRAM .Ce 
vecteur pointe sur une routine copiant le buffer de la 
BRAM se trouvant dans le bank $E1BATTERYRAM 
dans la ram du circuit horloge avec la bonne somme 
de contrdle. Cette routine est appelee par le Miscel- 
lanous Tool Set 

$0084-$0087 TOREADBR : 

Vecteur sur la routine de lecture de la BRAM. Ce 
vecteur pointe sur la routine copiant le contenu de la 
Ram du circuit horloge, dans le buffer du bank $E1. 
Si la somme de controle est invalide, ou I'un des 
param^tres est hors limite, les paramMres par de- 
fauts sont recopies et dans le buffer et dans la Ram 
du circuit horloge. 

$0088-$008B TOWRITETIME : 

Ce vecteur pointe sur une routine ecrivant dans le 
registre des secondes du circuit horloge. Elle trans- 
f^re les valeurs se trouvant dans le buffer 
CLKWDATA dans le bank $E1 dans le circuit hor- 
loee. 

$008C-$008F T^^READTIME : 

Ce vecteur pointe sur une routine lisant les registres 
des secondes du circuit horloge et le recopiant dans 
le buffer CLKWDATA du bank $E1. En cas d'^chec 
au retour le bit carry est ^ 1. 

$0090-$0093 TOCTRLPANEL : 

Ce vecteur pointe sur le programme du panneau de 
contrdle . 11 suppose qu'il a ete appele par le Desk 
Manager, et suppose une inialisation correcte de 
plusieurs zones en page zero. 

$0094-$0097 TOBRAMSETUP : 

Ce vecteur pointe sur une routine initialisant le sys- 
tem' en fonction des param^tres contenus dansle 
bufl i BATTERYRAM. De plus si on appelle cette 
rout" ne avec le bit carry ^ il positionne la configura- 
tion des slots (internes externes). Le buffer 
BATTERYRAM dans le bank $E1 ne peut etre mis h 
jour que grace au Miscellanous Tool Set. 
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$0098-$009B 



TOPRINTMSG8 : 

Ce vecteur pointe vers une routine affi chant la chaine 
ASCn pointee en multipliant le contenu de I'accu- 
mulateur par 2 et en s'en servant comme index dans 
la table points par MSGPOINTER (3 bytes). Cette 
routine est utilis^e par le panneau de contrdle int^ 
gre, par les panneaux de contrSle en RAM,etparle 
moniteur. 



$009C-$009F 



$00A0-$00A3 



$00A4-$00A7 



$00A8-$00AB 



TOPRINTMSG16 : 

Ce vecteurpointe vers une routine affichant la 
chaine ASCII pointee par le contenu de I'accumula- 
teur 16 bits et en s'en servant comme index dans la 
table pointee par MSGPOINTER (3 bytes). Cette rou- 
tine est utilisee par le panneau de contrdle int^gr^, 
par les panneaux de controle en RAM, et par le mo- 
niteur. 

CTRLYVECTOR : 

Saut inconditionel vers une routine usager traitant le 
CTRL-Y. Cette routine est appelee en mode 8 bit 
natif, avec le regis tre Data Bank initialise k zero et le 
registre Direct h $0000. Cette routine doit preser 
ver le registre Data bank, le registre Direct, la Vi- 
tesse et revenir en mode emulation avec un RTS de la 
bank $00. Si aucun vecteur n'est installe le moniteur 
^x^cutera la routine pointee en bank $00 /USRADR. 
Ce vecteur est utilise par les debuggueurs. 

TOTEXTPG2DA : 

Ce vecteur pointe vers I'accessoire «Aternate Dis- 
play Mode». II suppose qu'il a ete appel6 par le Desk 
Manager. II retourne au Desk Manager via un RTL 
lors de la pression d'une touche. Ce vecteur etait 
detourn^ par les anciennes versions du Diversi 
Cache. 

PR016MLI : 

Point d' entree du MLI ProDOS/16, avec code com- 
mande et adresse des param^tres suivant le JSL. 
Ex: JSL$E1/00A8 

DAcmd 

DDW parms 
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$OOAC-$OOAF 
$00B0-$00B3 



$00B4-$00B7 

$00B8-$00BD 

$OOBC 



$OOBD 



$00C0-00C2 



$OOFF 



PR016MLI : 

Point d'entree du MLI ProDOS/16 avec param^tres 

pousses sur la pile. 

PushL parms 

PushW cmd 

JSL $E1/00B0 



OS_KIND $00 ProDOS/8 
$01 Gs/OS ou ProDOS/16 

OS_BOOT : 

Cette valeur indique quel syst&me h ete initialement 

boote : $01 Gs/OS ou ProDOS/16 

$00BE-$00BF bit 15 a 1 si Prodos 16 en 
cours d' execution d'un appel 

MSGPOINTER : 

Pointeur vers la tables des adresses des chaines utili- 
sees par le Panneau de controle le moniteur ..., la 
forme de ce pointeur est poids faible/poids 
fort/no de banc. 

BUSYFLAG : 

(Localisation non suportee par Apple) 



2.4.2.2 Autres variables en $E1 
$02B8-$02BF Buffer souris. 



$02C0-$03BF 

$03C0-$O3CF 
$03D0-$03DF 

$03E0-$03FF 
$0400-$07FF 
$0800-$0BFF 



BATTERYRAM : 

Buffer oCi est recopie le contenu de la Ram sauve- 

gardee du circuit norloge. 

Variables du Localisateur de Tools. 

Listes des interruptions de I'ADB 
(Apple Desktop Bus ). 

Buffer horloge. 

Texte page 1 . 

Texte page 2. 
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$OCOO-$OFCF 

$0FD0-$0FD5 

$0FD6-$OFFA 

$OFFB-$OFFF 

$1000-$14E1 

$14E2-$1549 

$154A-$1589 

$158A-$15A9 

$15AA-$15C0 

15C1-$15CC 

$15CD-$15FD 

$15FE-$19B7 

$19B8-$1DAF 

$1DB0-$1DCF 

$1DD0-$1DD7 

$1DD8-$1FFF 

$2000-$3FFF 

$4000-$5FFF 

$6000-$9FFF 

$AOOO-$BFFF 

$COOO-$CFFF 

$DOOO-$DFFF 

$EOOO-$FFFF 



Buffer de transfert disque. 

Utilise par les Tools. 

Zone de stockage de I'ADB. 

Zone de stockage du port serie. 

Zone de stockage AppleTalk. 

Zone de stockage SmartPort. 

Liste des adresses/attributs ADB. 

Variables du port serie. 

Zone de stockage du TOOL texte. 

Variables du port serie. 

Reserve. 

Buffer du gestionnaire memoire. 

Reserve. 

Buffer des variables Son. 

Utilise par les Tools 

Buffer de la sortie serie 

Page graphique 1 

Page graphique 2 

Zone super-Hires 

Memoire libre geree par le gestionnaire memoire. 

Zone des entrees sorties 

Buffers AppleTalk 

Code AppleTalk 
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2.5 BRAM ou BATTERYRAM . 

La Bram contient tons les paramttres, sauvegardes entredeux extinctions du 
Gs. Allocation des slots, etat du clavier, couleur de I'ecran, heure et date, 
format de celle-ci etc... 

2.5.1 Contenu de la BRAM 

Octet Fonction Normalement Limites 

Port 1 : 

$00 Fonction 

$00 $00-$01 
$00 imprimante 
$01 modem 

$01 Longueur de ligne 
$00 $00-$04 
$00 nonlimite 
$01 40 caractdres 
$02 72 caract^res 
$03 SOcaract^res 
$04 132 caract^res 

Nombre de caract^res regus ou transmis 
avant rajout d'un retour chariot. 

$02 Supprimer le premier saut de lignes apr^s le retour chariot, 
(supprimer le Line Feed $0A apr^s le 
Carriage Return $0D) 
$00 $00-$01 
$00 Non 
$01 Oui 

$03 Ajouter un saut de ligne apr^s le retour chariot. 
$01 $00-$01 
$00 Non 
$01 Oui 

$04 Echo $00 $00-$01 

$00 Absent 

:t>ui rresent arricne les caracteres 

transmis sur I'ecran. 

$05 Buffer$00 $00-$01 
$00 Non 
$01 Oui 
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' 



$06 Vitesse en bauds 




$0D $00-$0E 




$00 50 $07 


1200 


$01 75 $08 


1800 


$02 110 $09 


2400 


$03 134.5 $0A 


3600 


$04 150 $0B 


4800 


$05 300 $0C 


7200 


$06 600 $0D 


9600 


$0E 19200 





$07 Nombre de bits de donnees 
$06 $00-$07 
Nombre de bits de stop 
$00 5 bits de donnees 1 de stop 
$01 5 bits de donnees 2 de stop 
$02 6 bits de donnees 1 de stop 
$03 6 bits de donnees 2 de stop 
$04 7 bits de donnees 1 de stop 
$05 7 bits de donnees 2 de stop 
$06 8 bits de donnees 1 de stop 
$07 8 bits de donnees 2 de stop 

$08 Parite$02 $00-$02 
$00 Impaire 
$01 Paire 
$02 Aucunne 

$09 DCD Handshake 
$01 $00-$01 
$00 Non 
$01 Oui 

$0A DSR/DTR Handshake 
$01 $00-$01 
$00 Non 
$01 Oui 

$0B XON/XOFF Handshake 
$00 $00-$01 
$00 Non 
$01 Oui 
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Port 2 : Idem port 1 

$0C Fonction 
$01 $00-$01 

$0D Longueur de ligne 
$00 $00-$04 

$0E Supprimer le premier Saut de lignes $00 $00-$01 
apr^s le retour chariot. 

$0F Ajouter un saut de ligne apr^s le $00 $00-$01 
retour chariot. 

$10 Echo $00 $00-$01 

$11 Buffer $00 $00-$01 

$12 Vitesse en bauds 
$07 $00-$0E 

$13 Nombre de bits de donnee 
$06 $00-$07 
Nombre de bits de stop 

$14 Parite $02 $00-$02 

$15 DCD Handshake 

$01 $00-$01 

$16 DSR/DTR Handshake 
$01 $00-$01 

$17 XON/XOFF Handshake 
$00 $00-$01 
Divers : 

$18 Affichage couleur/ monochrome $00 $00-$01 
$00 Couleur 
$01 Monochrone 

$19 Affichage 40/80 colonnes 
$00 $00-$01 
$00 40 colonnes 
$01 80 colonnes 
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$1 A Couleur pour le texte 
$0F $00-$0F 

$08 Marron 
$09 Orange 
$0A Gris clair 
$0B Rose 
$0C Vert pale 
$0D Jaune 
$0E Aquamarine 
$0F Blanc 



$00 


Noir 


$01 


Rouge sombre 


$02 


Bleu sombre 


$03 


Pourpre 
Vert foncee 


$04 


$05 


Gris sombre 


$06 


Bleu 


$07 


Bleu clair 


$1B Couleur pour le fond 


$06 


$00-$0F 



$1C Couleur pour le bord 
$06 $00-$0F 

$1D 50 ou 60 Hertz 
$00-$01 
$00 50 hertz 
$01/ 60 hertz 

$1E Volume du haut parleur 
$06 $00-$0E 

$1F Tonalite du haut parleur 
$07 $00-$0E 

$20 Vitesse $00 $00-$01 
$00 Rapide 
$01 Lente 

$21 Utilisation du slot 1 
$00 $00-$01 
$00 Imprimante 
$01 Votre carte 

$22 Utilisation du slot 2 
$00 $00-$01 
$00 Modem 
$01 Votre carte 

$23 Utilisation du slot 3 
$00 $00-$01 

$00 Carte 80 colonne interne 
$01 Votre carte 
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$24 Utilisation du slot 4 
$00 $00-$01 
$00 Portsouris 
$01 Votre carte ^ 

$25 Utilisation du slot 5 
$00 $00-$01 

$00 Port intelligent (smart port) 
$01 Votre carte 

$26 Utilisation du slot 6 
$00 $00-$01 
$00 Portdisque 
$01 Votre carte 

$27 Utilisation du slot 7 
$01 $00-$01 
$00 Appletalk 
$01 Votre carte 

$28 Slot de d^marage 
$00 $00-$09 

$00 Recherche des slots pour le 
demarrage commence la recherche k 
partir du slot 7 
$01 -$07 slot de demarrage 
$08 Demarre h partir du disque RAM 
$09 Demarre k partir du disque ROM 

$29 Langue de I'affichage. 

$00 $00-$lF 

$00 Anglais (USA) * x 

$01 Anglais (UK) * x 

$02 Frangais * x 

$03 Danois * x 

$04 Espagnol * x 

$05 Italien * x 

$06 AUemand * x 

$07 Suedois * x 

$08 «Dvorak» x 

$09 Canadien (frangais) x 

$0A Flamand 

$0B Hebreux 

$0C Japonnais 

$0D Arabe 

$0E Grec 

$0F Turn 



I 
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$10 Finnois 

$11 Portuguais 

$12 Tamal 

$13 Hindi 

$14-$1F Reserve aux extensions futures. 

* Valeurs correspondantes aun jeu de caracteres valide. 

$2A Langue du clavier 
$00 $00-$lF 
Disposition des touches 
(Codes identiques h ci-dessus) 

X Valeurs correspondant d. un clavier valide. 

$2B Bufferisation du clavier 
$00 $00-$01 
$00 Non 
$01 Oui 

$2C Vitesse de repetition du clavier $03 $00-$07 

$00 4 caracteres par seconde 

$01 8 caracteres par seconde 

$02 11 caracteres par seconde 

$03 15 caracteres par seconde 

$04 20 caracteres par seconde 

$05 24 caracteres par seconde 

$06 30 caracteres par seconde 

$07 40 caracteres par seconde 

$2D Delai avant repetition d'une touche 

$02 $00-$04 

$00 l/4de seconde 

$01 1/2 seconde 

$02 3/4 de seconde 

$03 1 seconde 

$04 pas de repetition 

$2E Vitesse du double clic 

$02 $00-$04 

$00 50 tics un tics = 1/60 erne de seconde 

$01 40 tics 

$02 30 tics 

$03 20 tics 

$04 10 tics 
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Duree entre deux dies souris au bout de laquelle on consi - 
dhe qu'il nes'agit plus d'un double die, mais de deux dies 
distincts. 

$2F Vitesse de clignotement du curseur 

$02 $00-$04 

$00 tics ne clignote pas 

$01 60 tics 

$02 30 tics 

$03 15 tics 

$04 10 tics 

$30 Shift caps /Lover case 
$00 $00-$01 
$00 Non 
$01 Oui. 

Si la louche de verrouillage majuscule est enfoncee, la 
louche shift permet d'obtenir les minuscules, les chiffres et 
les s}/mboies ne sent pas affectes. 

$31 Barre d'espace et touche d'effacement rapide. 
$00 $00-$01 
$00 Non 
$01 Oui. 

Permet une repetition accderee de la louche d'effacement 
d de la barre d'espace lorsque la touche CONTROL est 
maintenue enfoncee simultaneement. 

-> Touches h Deux vitesses. 

Nota : les filches obeissent dej^ k cette technique. 

$32 Double Vitesse 
$00 $00-$01 
$00 Prendre en comple les paramHres du panneau de con- 

Irole pour la vitesse de repetition des touches a deux 

vitesses. 
$01 Prendre comme Vitesse de repdition la vitesse maxi- 

male possible. 
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$33 Souris rapide 

$00 $00-$01 

$00 Ne pas prendre en compte la vitesse de deplacement dans 
le calcul de la position du pointeur de la souris. 

$01 Le pointeur souris se deplacera plus loin pour le meme 
mouvement de la souris suivant la vitesse de deplace- 
ment de celle ci. 

$34 Format de la date 
$00 $00-$02 

$00 Mois /Jour/Annee 
$01 Jour / Mois / Annee 
$02 Annee / Mois / Jour 

Mois, Jour et Annee sur 2 chiffres chacun 

$35 Format de I'heure 
$00 $00-$01 
$00 surl2heures 
$01 sur 24 heures 

$36 Taille minimum du RAM disk 
$00 $00-$20 

Valeur = nombre de blocs de 32k 

$37 Taille maximum du RAM disk 
$00 $00-$20 

Valeur = nombre de blocs de 32k 

$38-$40 Liste des langues d'affichage disponibles. 

$41-$51 Liste des dispositions de clavier disponibles. 
$52-$7F Reserve 

$80 Numero de noeud Appletalk 

$81-$A1 Variables du systeme d' exploitation 
$A2-$FB Reserve 
$FC-$FF Somme de controle. 

Si cette somme est invalide, la configuration par 

difaut est installk. 

2.5.2 Lecture Ecriture dans la Bram 

On utilise pour cela le Miscellanous Tool Set. 
Quelques Macros. 
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Tool MAC 



LDX #]1 ; charge le numero d'appel du tool ft 

JSL $E10000 ; Appel au dispatcher ^ 

<« 

I 



WriteBParam MAC 

Tool $B03 

<« 

_ReadBParam MAC 

Tool $C03 

<« 

; Lecture d'un param^tre en BRAM 

; attention on doit etre en mode natif et 16 bits 

PEA $0000 ; Reserve de la place pour le 

; resultat sur la pile 
PEA $0020 ; On veut la vitesse $20 en 

; param^tre de la BRAM 

_ReadBParam 

PLA ; resultat dans A 

; Ecriture d'un param^tre en BRAM 
PEA $0001 ; Vitesse rapide 
PEA $0020 ; vitesse 

WriteBParam 
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2.6 Les SOFTSWICHES (commutateurs logiciels) 



Residents de $EO/$COOO a $EO/$COFF et de $E1 /$C000-$E1 /$COFF 
en emulation Apple II et suivant le registre d'effet Miroir resident 
aussi en $00/$COOO-$COFF et $01/$C000-$C0FF. 

Meme remarque pour I'espace des entrees sorties residant de $C100- 
$CFFF. 



Adresse 
Operation valide : 



$cooo 



$C010 * 
$C001 * 



$C002 * 

$C003 * 

$C004* 
$C005 * 



Lect : lecture 
Ecr : ecriture 
L/E : lect Ecr 



Description 

Lect Donnees du clavier bit 7 a 1 si une touche k 
ete pressee : 

Ex : loop LDA $C000 ; attend la 

; pression 
; d'une 
BPL loop ; touche 
; resultat 
; dans A 

Ecr CLR80COL utilise la memoire principale 

Ecr SET80COL permet I'utilisation de la memoire 
auxiliaire, on selectione la memoire auxiliare ou la 
memoire principale en ecrivant en TXTPAGEl ou 
TXTPAGE2 (memoire auxiliare) avec le commuta- 
teur HIRES off on ne commute que $400-$7FF (text 
page 1) sinon on commute la page graphique 1 
($2000-$3FFF) en plus. 

Ecr RDMAINRAM lecture h partir de la memoire 
principale 

Ecr RDCARDRAM lecture k partir de la memoire 
auxiliare 

Ecr WRMAINRAM ecriture en memoire principale. 

Ecr WRMAINRAM ecriture en memoire auxiliaire. 
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$C006 

$C007 

$C008* 

$C009* 

$COOA 

$COOB 

$COOC 



$COOD 

$COOE 

$COOF 

$COOF 
$C010 



Ecr SETSLOTCxROM valide la rom se trouvant 
sur les cartes d'interfaces. ($C100-$CFFF espace 
memoire des entrees sorties ) Fonctionne conjointe 
merit a RDCxROM 

Ecr SETINTCxROM valide la rom interne 
$C100-$CFFF 

Ecr SETSTDZP Page Zero et Pile en memoire 
principale 

Ecr SETALTZP Page Zero et Pile en memoire 
auxiliaire 

Ecr SETINTC3ROM valide la rom interne h 
$C300. (rom de la carte 80 colonnes ) 

Ecr SETSLOTC3ROM valide la rom de la carte 80 
colonnes. 

Ecr CLR80VID desactive I'affichage 80 colonnes. 
(attention ne desactive que le mode physique non le 
logiciel qui continue k afficher en 80 colonnes la 
methode la plus propre pour repasser en 40 colon 
nes consiste h demander I'affichage d'un CTRL-Q). 

Ecr SET80VID active I'affichage 80 colonnes. 
(meme remarque) 

Ecr CLRALTCHAR lettres minuscules normales 
Lettres majuscules clignotantes 

Ecr SETALTCHAR Jeu de caracteres Normaux et 
inverses pas de lettres clignotantes. 

Lect idem$C010 

L/E KBDSTRB Remet h zero le flag Touche 

enfonc^e 

le contenu de $C000 devient < 128 

Ex : LDA $C000 A = $C1 code ascii de A 



BIT $C010 
LDA $C000 



A= $41 
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$C01 1 * Lect RDLCBNK2 le bit 7 de cette adresse indique le 
banc memoire actif de la carte language 

1 $D000 bank 2 
$D000 bank 1 



Ex 



LDA $C011 
BPL bankl 



bankl 



; Le banc 1 est actif 
; dans la carte 
; language 

; le banc 2 est actif 
; dans la carte 
; language 

$C012 * Lect RDLCRAM le bit 7 de cette adresse indique si 
on lit sur la carte language ou sur la ROM 
1 Carte language 
ORom. 

$C013 * Lect RDRAMRD le bit 7 indique si on lit dans les 
48kde la memoire auxiliaire. 
1 Memoire auxiliaire 

Memoire principale 

$C014 * Lect RDRAMWRT le bit 7 indique si on 

ecrit dans les 48k de la memoire auxiliaire. 

1 Memoire auxiliaire 
Memoire principale 

$C015 Lect RDCxROM le bit 7 indique I'etat 

du commutateur SLOTCXROM 1 la memoire des 
cartes est utilisee la memoire interne est utilisee. 
Cet indicateur est utilise conjointement 
h. SETSLOTCxROM et SETINTCxROM 

STA SETSLOTCxROM 
LDA RDCxROM A >= $80 
BMI XXX 

; le branchement ser a pris 

STA SETINTCxROM 

LDA RDCxROM A < $80 

BPL XXX 

; le branchement sera pris 
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$C016 * Lect RDALTZP Le bit 7 est ^ 1 si la pa^e z6ro et la 
pile de la m^moire auxiliaire sont activee. 
(Commutateur SETALTZP) 



$C017 Lect RDC3ROM le bit 7 indique I'etat du commuta- 
teur SLOTC3ROM 1 la memoire des cartes est utili- 
see la memoire interne est utilisee. 
Cette indicateur est utilise conjointement k 
SETSLOTC3ROM et SETINTCfSROM 

$C018 Lect RD80COL le bit 7 est ^ 1 si utilisation de la 
memoire auxiliaire pour I'affichage. 
(Commutateur SET80COL/CLR80COL) 

$C019 Lect RDVBLBAR le bit 7 est ^ 1 si pas en VBL 

$C01 A Lect RDTEXT le bit 7 est ^ 1 si on se trouve en mode 
texte. 
(Commutateurs TXTCLR/TXTSET) 

$C01B Lect RDMIX le bit 7 est ^ 1 si on se trouve en mode 
mixte texte et graphique. 
(Commutateurs MIXCLR/MIXSET) 

$C01C Lect RDPAGE2 le bit 7 est ^ 1 si on se trouve sur la 
page 2. 
(Commutateurs TXTPAGEl /TXTPAGE2) 

$C01 D Lect RDHIRES le bit 7 est & 1 si on se trouve en mode 
haute resolution. 
(Commutateurs HIRES) 

$C01E Lect ALTCHARSET le bit 7 est ^ 1 si on affiche dans 
le ieu de caract^res alternatifs, 
(Commutateurs CLRALTCHAR/SETALTCHAR) 

$C01F Lect RD80VID le bit 7 est a 1 si I'affichage est en 80 
colonnes. 
(Commutateurs CLR80VID/SET80VID) 

$C020 Reserve 



142 



copyright Toolbox 1990 



$C021 L/E MONOCOLOR: 

Bit 0-6 : Reserve 
Bit 7 : Si bit ^ 1 on affiche des nuances de gris 
sinon I'affichage est en couleurs. 

$C022 L/E TBCOLOR: 

Registre de couleur du texte. 



$C023 



$C024 



Bit 0-3 : 


couleur du fond 




Bit 4-7 : 


couleur du texte 






$0 Noir 


$8 Marron 




$1 Rouge sombre 


$9 Orange 




$2 Bleu fonce 


$A Gris clair 




$3 Pourpre 
$4 Vert fonce 


$B Rose 




$CVert 
$D Jaune 




$5 Gris fonce 




$6 Bleu 


$E Aquamarine 




$7 Bleu clair 


$F Blanc 



L/E VGCINT registre d'interruption 
du controleur video 



BitO 
Bitl 
Bit 2 
Bit 3 
Bit 4 
Bits 
Bite 
Bit 7 



Reserve 

Autorise interruption de fin de ligne 

Autorise les interruptions de 1 seconde 

Reserve 

Reserve 

Status de 1' interruption de fin de ligne 

Status de interruption de 1 seconde 

Status de I'interruption VGC 

Bits de status ^ 1 si une interruption de ce 

type k eu lieu. 

Bit k 1 pour autoriser une interruption. 

Lect MOUSED ATA : 

registre de donnee de la souris. Les don- 
nees generees par la souris lors des depla- 
cements ainsi que I'etat du bouton sont 
accessibles via ce registre. Ce registre 
doit etre lu deux fois successivement, la 
premiere lecture renvoyant la coordon 
nee en Y la seconde celle en X 
Bit 7 : Etat du bouton si bouton enfonce 
Bit 6 : Variation de mouvement si 1 negatif 

Bit 5-0 : Mouvement de la souris 
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$C025 



$C026 



Lect KEYMODREG: 

registre de status des touches mortes du 
clavier. (Shift Controle Pomme 
CapsLock) 



Bit 7 
Bit 6 
Bits 
Bit 4 
Bit 3 
Bit 2 
Bitl 



pave numenque a 



^ 1 si la touche pomme 

a ete enfoncee. 

^ 1 si la touche 

Option a ete enfoncee. 

^ 1 si ce registre a 

ete modifie. 

^ 1 si une touche du 

ete enfoncee. 

^ 1 si une touche est 

enfoncee. 

^ 1 si la touche Caps 

Lock a ete enfoncee. 

^ 1 si la touche 

Controle a ete enfoncee. 

Bit ^ 1 si la touche Shift a ete enfoncee. 



L/E DATAREG: 

registre de donnee/commande du clavier 
Lors d'une interruption ce registre est defini 
de la fagon suivante. 



Bit 7 
Bit 6 
Bit 5 
Bit 4 



Bit 3 
Bit 2-0 



^ 1 si un octet de reponse, sinon octet de 

donnee. 

k 1 ABORT valide tous les autres bits de 

ce registre k 0. 

^ 1 si on ^ appuye sur 

CTRL-POMME-RESET 

^ 1 si on ^ appuye sur une sequence de 

vidange clavier. 

CTRL-POMME-DEL 

h 1 si SRQ valide 

nombre d'octets de donnees regu -1 

si pas de donnees valide. 



$C027 L/E KMSTATUS registre de status de I'ADB 



Bit 7 
Bit 6 
Bits 



^ 1 si le registre de donnee de la souris est 

plein. 

^ 1 si les interruptions de la souris sont 

autorisees 

^ 1 si le registre DATAREG contient des 

donnees valides. 
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Bit 4 : ^ 1 si une interruption est generee lorsque 

le contenu du registre DATAREG est va- 

lide. 
Bit 3 : ^ 1 si le registre de donnees du clavier est 

plein. 
Bit 2 : a 1 si une interruption est generee lorsque 

le contenu du registre de donnees du cla 

vier est valide 
Bit 1: ^ 1 si coordonnee X de a souris dans 

MOUSED ATA ^ si coordonnee Y 
Bit : ^ 1 si le registre de DATAREG est plein 

$C028 xxxx ROMBANK : 

bascule de selection de banc de ROM 
(inutilise sur le GS) 

$C029 L/E NEWVIDEO : 

Ce registre controle les capacites video 
supplementaire de 1' Apple IIGs. 

Bit 0-4 : Reserve ne pas modifier 
Bit 5 : Si cebitest^ Ola Double Haute Resolution 
est en couleur (140 par 1 92 en 1 6 couleurs) 
sinon la double haute resolution est en 
monochrome (560 par 192) 
Bit 6 : Si ce bit est ^ la carte memoire des 128k 
est la meme que sur 1' Apple He (necessai- 
re pour utilise la Double Haute Resolu 
tion) Si ce bit est k zero. Le buffer video 
devient une seule et meme zone me- 
moire contigue lineaire de $2000 h $9D00 
dans le bank $E1 
Bit 7 : Si ce bit est k tous les modes graphiques 
Apple II sont valide. Si ce bit est a 1 tous 
les modes graphiques Apple II sont inhi- 
bes I'etat du bit 6 est (considere comme 
h 1, memoire lineaire) La super resolu- 
tion est en action. 

$C02A xxxx Reserve futures extensions. 

$C02B L/E LANGSEL: 

Registre controlant le generateur de 

caracteres. 
Bit7-5 : Selection de la langue du generateur de 

caracteres 

: anglais (USA) 

1 : anglais (Uk) 
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$C02E 

$C02F 

$C030 
$C031 



Bit 4 
Bit 3 

Bit 2-0 



2 : Frangais 

3 : Danois 

4 : Espagnol 

5 : Italien 

6 : Allemand 

7 : Suedois 

^ 1 si mode PAL sinon sortie NTSC 

^ si jeu de caractere primaire 

selectionne. 

Reserve h . 



$C02C L/E CHARROM adresse pour les tests de lecture de 
la rem caractere. 



$C02D L/E SLTROMSEL 



Bit 0-4 
Bit? 

Bit 6 

Bits 

Bit 4 

Bit 3 
Bit 2 

Bitl 

BitO 

Lect 



Reserve ne pas modifier 
h 1 valide la carte du slot 7. 
ROM appletalk 
h 1 valide la carte du slot 6. 
Rom des lecteurs 5.25 
h 1 valide la carte du slot 5. 
Rom des lecteurs 3.5 
h 1 valide la carte du slot 4. 
Rom de la souris 
Reserve ne pas modifier 
h 1 valide la carte du slot 2. 
Rom de la sortie serie 2 
h 1 valide la carte du slot 1 . 
Rom de la sortie serie 1 
Reserve ne pas modifier 



valide la 
valide la 
valide la 
valide la 

valide la 
valide la 



VERTCNT : 

Adresse pour la lecture des bits du 

controleur video V5-VB 
Lect HORIZCNT : 

Adresse pour la lecture des bits 

controleur video VA-HO 
L/E SPKR: 

I'acc^s k ce registre produit un clic du haut parleur. 
L/E DISKREG: 
registre d'interface disque 



Bit 7 
Bite 
Bit 5-0 



h 1 selectionne la tete 1 sur le disque 3.5 

k selectionne la tete 

^ 1 on utilise un : lecteur 3.5 ^ un 

lecteur 5.25 
Reserve. 



* 
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$C032 L/E SCANINT: 

registre de remise k z^ro des interruptions VGC. 

Bit 5 : Remise k zero des ITsfin de ligne 
Bit 6 : Remise k zero des ITs 1 secondes 

Autres bits reserves. 

Pour remettre k zero les ITmettre k z6to 
le bit. 

$C033 L/E CLOCKDATA : 

registre de donnee de I'horloge. 

$C034 L/E CLOCKCTL: 

Permet de selectionner la couleur du bord et de 
controler I'horloge 

Bit 0-3 : Couleur du bord 

Bit 5 : Une fois le transfert du dernier octet, ou 
sa lecture, ce bit doit etre positionner k 1. 
Ce bit doit etre positionne k avant 
tout transfert avec I'horloge. 

Bit 6 : Positionner ce bit k 1 avant une lecture de 
I'horloge, k avant une ecriture 

Bit 7 : Ce bit doit etre positionner k 1 avant 

toute operation avec I'horloge, celle-ci le 
repositionne ^ ^ la fin de I'operation. 

$C035L/E SHADOW : 

registre shadowing 



BitO 
Bitl 
Bit 2 
Bit 3 
Bit 4 

Bit 5: 
Bit 6: 

Bit 7: 



pas de shadowing page text 1 si bit k 1 
pas de shadowing Hires page 1 si bit k 1 
pas de shadowing Hires page 2 si bit k 1 
pas de shadowing Buffer superhires si ^ 1 
pas de shadowing bank auxiliare hires si 

Reserve 

pas de shadowing pour la zone E/S si bit 

Reserve 
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$C036 L/E CYAREG registre de controle de la Vitesse 



Bit : slot 4 si bit k 1 vitesse lente sur 



$C037 



Bitl 
Bit 2 
Bits 
Bit 4 



Bits 
Bit 6 
Bit 7 



motor-on 

slots 

slot 6 

slot? 

si bit h 1 autorise les shadowing dans 

tous les bancs $00-$7F, k seulement 

dans les bancs 

$00 et $01 (mode normal) 

Ne pas utiliser le mode tous bancs. 

Reserve 

si bit h 1 vitesse rapide 

Bit 0-3 si une adresse motor-on 
($C0F9, $C0E9 $C0D9, $C0C9) 
est accedee la vitesse passe 
automatiquement k iMhz 
(vitesse lente compatible avec 
les peripheriques Apple 2) et 
sur I'acc^s k une adresse 
motor-off ($C0F8, $C0E8, 
$C0D8, $C0C8) la vitesse 
revient k sa valeur precedente 
Utilise pour permettre 
I'utilisation des unites de 
disquettes 5 pouces ne 
fonctionnant qu' k IMhz 



L/E DMAREG: 

Utilise lors des accfes DMA comme adresse de 

banc. 



$C038 L/E SCCBREG: 

Registre de commande du port serie 

numero 2 
$C039 L/E SCCAREG : 

Registre de commande du port serie numero 1 
$C03A L/E SCCBDATA: 

Registre de donnee du port serie numero 2 
$C03B L/E SCCADATA : 

Registre de donnee du port serie numero 1 
$C03C L/E SOUNDCTL: 

registre de controle du son. 
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$C03D 

$C03E 
$C03F 
$C040 
$C041 



$C042 
$C043 
$C044 

$C045 



Bit7 
Bit6 



Bits 

Bit 4 
Bit3-0 



^ 1 le DOC est occupe. ce bit doit Stre k 

zero pour pouvoir travailler avec le DOC 

h 1 tous les acc^s sont dans la ram dediee 

de 64k si bit ^ on accede aux registres du 

DOC. 

^ 1 on autorise I'auto incrementation des 

adresses. 

Reserve ne pas modifier 

Volume sonore de ^ $F, $F le plus fort. 



L/E SOUNDDATA: 

Registre de donnee du DOC. Donnees venant de la 

Ram de 64k ou des registres du DOC suivant le bit 

6 du registre precedent. 

L/E SOUNDADRL: 

Poids faible de I'adresse dans la ram du DOC 

L/E SOUNDADRH: 

Poids fort de cette meme adresse. 

xxxx : Reserve aux extensions futures. 

L/E INTEN 

Bit 7-5 : Reserves. 
Bit 4 : ^1 autorise les interruptions quart de 

seconde 
Bit 3 : ^ 1 autorise les interruptions VBL 
Bit 2 : ^1 autorise les interruptions boutons 

de la souris en mode Apple II 
Bit 1 : ^1 autorise les interruptions mouve- 

ments de la souris en mode Apple II 
BitO : h 1 valide la souris en mode Apple II 

(mega 2) 

xxxx : Reserve aux extensions futures. 

xxxx : Reserve aux extensions futures. 

Lect MMDELTAX variation du mouvement 
de la souris mode Apple 2 axe 
des X. (complement k 2) 

Lect MMDELTAY variation du mouvement 
de la souris mode Apple 2 axe 
des Y. (complement k 2) 



$C046 Ecr DIAGTYPE 
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Bit 7 : 1 si diagnostics ROM 
$C047Lect INTFLAG : 
Bit 7 



Bit 6 



Bit 5; 
Bit 4: 

Bit 3: 
Bit 2: 

Bitl 



^ 1 si le bouton de la souris est 

enfonce 

^ 1 si le bouton de la 

souris etait enfonce lors de la derni^re 

lecture 

Status de la sortie AN3 

h 1 s'il y ^ eu une interruption quart de 

seconde 

^ 1 s'il y a eu une interruption VBL 

h 1 s'il y a eu une interruption due h. la 

pression du bouton de la souris 

a 1 s'il y a eu une interruption due k un 

deplacement de la souris 



$C047Ecr CLRVBLINT : reinitialise I'interruption VBL 

$C048Ecr CLRXYINT : 

reinitialise les interruptions de la souris mode 
Apple 2. 

$C049 xxxx : Reserve aux extensions futures. 

$C04A xxxx : Reserve aux extensions futures. 

$C04B xxxx : Reserve aux extensions futures. 

$C04C xxxx : Reserve aux extensions futures. 

$C04D xxxx : Reserve aux extensions futures. 

$C04E xxxx : Reserve aux extensions futures. 

$C04F xxxx : Reserve aux extensions futures. 

$C050 L/E TXTCLR: 

Selectionne le mode graphique «standard» Apple II 

$C051 L/E TXTSET: 

Selectionne le mode texte. 

$C052 L/E MIXCLR: 

Positionne en mode plein graphique. 
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$C053 L/E MIXSET: 

Positionne en mode mixte graphisme plus 4 lignes 
de texte. 

$C054 L/E TXTPAGEl : 

Selectionne la page 1 texte ou graphique 

$C055 L/E TXTPAGE2: 

Selectionne la pa§;e 2 ou si on a utilise SET80COL 
(memoire auxiliaire pour I'affichage) la page 1 en 
memoire auxiliaire. 

$C056 L/E LORES : 

Selectionne le mode graphique basse resolution. 

$C057 L/E HIRES: 

Selectionne le mode haute resolution ou si on a 
utilise SETAN3 la Double Haute resolution 

Ex: STA SETAN3 ; passe 

; en double haute 
STA HIRES 

$C058 Ecr SETANO : positionne 1' annunciator 

$C059 Ecr CLRANO : efface I'annunciator 

$C05A Ecr SETANl : positionne I'annunciator 1 

$C05B Ecr CLRANl efface I'annunciator 1 

$C05C Ecr SETAN2 positionne I'annunciator 2 

$C05D Ecr CLRAN2 efface I'annunciator 2 

$C05E L/E SETAN3 autorise la double haute 
resolution. 

$C05F L/E CLRAN3 inhibe le mode double 
haute resolution. 

$C060 Lect BUTN3 lire le bouton 3 du 
joystick 

$C061 Lect BUTNO lire le bouton du 
joystick 
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$C062 Lect BUTNl lire le bouton 1 du 
joystick 

$C063 Lect BUTN2 lire le bouton 2 du 
joystick 

$C064 Lect PADDLO Lecture paddle 

$C065 Lect PADDLl Lecture paddle 1 

$C066 Lect PADDL2 Lecture paddle 2 

$C067 Lect PADDL3 Lecture paddle 3 

$C068 L/E STATEREG Registre regroupant 8 

commutateurs communement utilises sur 1' Apple IL 

Bit 7 : 1 si diagnostics ROM 

Bit : INTCXROM $C007,$C006, 

Si bit ^ 1 la rom interne en $CxOO est 

selectionnee. 
Bit 1 : ROMBANK 

Ce bit doit toujours etre h 0. 

Ne pas modifier. 
Bit 2: LCBNK2 $C083,$C011 

Si bit k 1 Bank 1 de la 

carte language selectionne. Bank 2 sinon. 
Bit 3 : RDROM $C080, $C012 

Si bit ^ 1 la ROM de la 

carte language est validee sinon il s'agit de 

la RAM. 
Bit 4: RAMWRT $C009^008 

Si bit ^ 1 la RAM uxiliaire est validee 

en ecriture. 
Bit 5 : RAMRD $C009,$C008 

Si bit ^ 1 la RAM auxiliaire est validee 

en lecture. 
Bit 6: PAGE 2 $€054^055 

Si bit ^ 11a page 2 est selectionnee. 
Bit 7 : ALTZP $C009,$C016 

Si ce bit est ^ 1 la page zero et la pile 

se trouve en memoire principale. 
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$C06A 
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xxxx Reserve aux extensions futures 
xxxx Reserve aux extensions futures 



\ 



$C06B 

$C06C 

$C06D 

$C06E 

$C06F 

$C070 

$C071 

$C07F 

$C080 * 
$C081* 

$C082* 

$C083* 

$C084* 
$C085* 

$C086* 

$C087* 

$C088* 



xxxx Reserve aux extensions futures 

xxxx Reserve aux extensions futures 

L/E TESTREG registre de mode de test 

Ecr CLRTM devalide le mode test. 

Ecr ENTM valide le mode test. 

Ecr PTRIG : reinitialise la lecture des Paddles 

Lect Code de traitement des interruptions. 

Lect RDDHIRES : 

le bit 7 est ^ 1 si le mode double haute resolu- 
tion est actif. 
(Commutateurs SETAN3/CLRAN3) 

Lect Lire cette adresse pour passer en lecture 
RAM de la carte langage utiliser $D000 bank 
2 et proteger 1 h RAM en ecriture. 

L/L ROMIN: 

Lire deux fois cette adresse pour lire la ROM 
(carte langage) valider en ecriture la RAM en 
utilisant $D000 bank 2. 

Lect Lire cette adresse pour valider la ROM en 
lecture empecher I'ecnture en RAM et utiliser 
$D000 bank 2 

L/L Lire deux fois cette adresse pour valider 
la RAM en lecture et en ecriture avec pour 
$D000 bank 2 

Lect Idem$C080 
L/L Idem$C081 

Lect Idem$C082 

L/L Idem$C083 

Lect Lire cette adresse pour passer en lecture 
RAM de la carte langage utiliser $D000 bank 
1 et proteger la RAM en ecriture. 
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$C089* 

$C08A* 

$C08B* 

$C08C* 

$C08D* 

$C08E* 

$C08F* 

$C090 
$C09F 

$COAO 
$COAF 

$COBO 
$COBF 

$COCO 
$COCF 

$CODO 
$CODF 

$COEO 
$COEF 
$COFO 
$COFF 



L/L Lire deux fois cette adresse pour lire la 
ROM (carte language) valider en ecriture la 
RAM en utilisant $D000 bank 1. 

Lect Lire cette adresse pour valider 

la ROM en lecture, empecher I'ecriture en 

RAM et utiliser $D000 bank 1 

L/L Lire deux fois cette adresse pour valider 
la RAM en lecture et en ecriture avec pour 
$D000 bank 1 

Lect Idem$C088 

L/L Idem$C089 

Lect Idem$C08A 

L/L Idem$C08B 

??? Commutateurs reserves au slot 1 

??? Commutateurs reserves au slot 2 

??? Commutateurs reserves au slot 3 

??? Commutateurs reserves au slot 4 

??? Commutateurs reserves au slot 5 

??? Commutateurs reserves au slot 6 
??? Commutateurs reserves au slot 7 



(*) Commutateurs utiles generalement seulement en mode 
emulation Apple 2. 
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Rom des cartes d'extensions, la rom en presence depend de 
$C02D SLTROMSEL 

$C100 Lect 

$C1FF Rom carte slot 1 ou Rom interne 

$C200 Lect 

$C2FF Rom carte slot 2 ou Rom interne 

$C300 Lect 

$C3FF Rom carte slot 3 ou Rom interne 

$C400 Lect 

$C4FF Rom carte slot 4 ou Rom interne 

$C500 Lect 

$C5FF Rom carte slot 5 ou Rom interne 

$C600 Lect 

$C6FF Rom carte slot 6 ou Rom interne 

$C700 Lect 

$C7FF Rom carte slot 7 ou Rom interne 

$C800 Lect 

$CFFF Rom carte ou Rom interne 



$CFFF Lect D^valide la Rom en $C800 
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3.0 Les Memoires de masse 

Dans le GS on trouve principalement quatre types de memoires de 
masse. Les disques Ram et Rom, les unites de disques souples ou 
floppy et les disques durs. Ces memoires sont gerees, plus ou moins 
bien,j)ar le syst^me d'exploitation disque soit DOS, PRODOS ou 
GS/OS ou etc ... 

Dans ce chapitre nous allons tenter de decrire les differents moyens 
d'acc^s aux memoires de masse du GS. 

Le GS peut supporter trois types de floppy. Deux, acceptant des 
disquettes 3 pouces et demi, d'une capacity de 800k, et un, des 
disquettes 5 pouces un quart, d'une capacite de 140k par face. Les 
deux versions 3 pouces 1/2 se differencient principalement par la 
presence ou non d'un processeur h I'interieur, il s'agit des Apple 3.5 
(sans processeur) et des Unidisk 3.5 (avec processeur). Seuls les 
UniDisk 3.5 peuvent fonctionner indifferemment sur 1' Apple lie, lie 
et II^s. Quand au lecteur 5 pouces il s'agit du duodisk ou de I'unidisk 
5" herite de 1' Apple II 



3.1 Quelques rappels sur rorganisation des disques 
3.1.1 DOS 3.3 

Le DOS 3.3 (k plus forte raison les versions anterieures) utilise unique- 
ment les disquettes 5 pouces un quart (I'utilisation des disquettes 3 
pouces et demi necessitant un DOS modifie non fourni par Apple). 

Le formatage (operation consistent k preparer le support magnetique 
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a ro'.evoir des donnees en le divisant en pistes et secteurs ) est 
contrairement k certaines machines (suivez mon regard) realise en 
^;rande partie par voie jogiciel. 

La structure d'une disquette 5' 1 /4 apr^s formatage est la suivante : 

35 p'stes numerotees de ^ 34, chacune composee de 16 secteurs eux 
memes numerotes de ^ 15. Chaque secteur contient 256 octets 
d'information utile. On obtient ainsi unecapacite de 4 kilos octets par 
piste soit 1 40 k par disquette. (Je rappelle qu'une face seulement de la 
disquette est utilisee, en retournant la disquette on gagne 140 K) 

Chaque piste sur le disque est formee d'une suite d'octets represen- 
tant les aonnees. 

Ces octets doivent satisfaire certaines conditions propres k la logique 
du format 

- bit de poids fort k 1 

- au plus une paire de bits consecutifs k zero. 



Le format d'une piste est le suivant : 

Gap 1 : 

Zone composee d'un certain nombre 
d'octets $FF «synchronises» 
permettant le remplissage de la 
piste. 12 ^ 85 suivant la piste. 

Secteur : 



Secteur 15 : 

Chacun de ces secteurs se decomposent de la fagon suivante 
Champ adresse : 

- Marque d'adresse Prologue soit D5 AA 96 
-Volume soit deux octets 

- Numero de piste soit deux octets 

- Numero de secteur soit deux octets 

- Somme de controle soit deux octets 

- Marque d'adresse Epilogue soit DE AA EB 
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Gap 2: 

Idem gap 1 mais generalement 5-10 octets h $FF. 

Champ de donn^: 

- Marque de donnee Prologue soit D5 AA AD 

- 342 octets de donnees 

- Somme de controle soit un octet 

- Marque de donn^ Epilogue soit DE AA EB 



Gap 3: 

Idem Gap 2 longueur 16-28 

les informations de volume, piste, secteur ainsi que le checksum 
(somme de controle) sont encodees sur deux octets suivant un codage 
appele 4 4. 

Soit d7d6d5d4d3d2dldl les bits de I'octet h encoder suivant la me- 
thode 4 4, en sortie on obtient Id71d51d31dl et Id61d41d21d0 deux 
octets satisfaisant aux conditions exprimees. 

Exemple : pour la piste 00 on a les octets $AA et $AA soit 1010 1010 
et 1010 1010, pour le secteur $F on a les octets $AF $AF soit 1010 1111 
et 1010 1111. 

La somme de controle est calculee de telle fagon que le ou exclusif de 
toutes les informations, elle meme y compris, donne zero. 

Les donnees sont elles encodees au format 6 2. Trois octets de donnees 
utiles donnant quatre octets sur disque. 

Les octets de synchronisation sont des octets ecrits de telle facon que 
h la suite des huit bits les composants on trouve deux bits ^ zero. Ce 
sont des octets h dix bits. 

Exemple un $FF synchronise sera compost sur le disque de : 
11111111 00. Le controleur ne pou vant lire que les octets commencant 
par un bit & 1, ces bits permettent h celui-ci de se synchroniser lors de 
la lecture, et ainsi de determiner le debut d'une suite d'octets valides. 

Je ne vais pas m'appesantir sur I'organisation des fichiers sous Dos, 
ce syst^me etant maintenant remplace par Prodos et GS/OS. 
Passons h la suite : PRODOS. 
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3.1.2 PRODOS, GS/OS 

Prodos, contrairement au DOS supporte plusieurs types d'unit^s de 
stockage. Celle ci sont des disques durs, des unites de disquettes 3 

gouces et demi et 5 pouces un quart, des cartes memoire RAM et 
OM. La base de stockage pour ces dif ferentes unites h ete normalisee 
et est le bloc. Un bloc contient exactement 2 secteurs d'une disquette 
5 pouces 1/4 soit 512 octets. 
On a done les capacit^s suivantes en blocs: 



Disquette 5 pouces 1 /4 

Disquette 3 pouces 1 /2 

Carte 1 Mo ram 

Rom disk 



280 blocs 
1600 blocs 
2048 blocs 
jusqu'^ 1024 blocs 



Le format des disquettes 5 pouces 1/4 est exactement le meme que 
sous DOS seul 1' organisation des f ichiers change, par centre le format 
des disquettes 3 pouces 1 /2 diff^re largement : 

2 faces composees chacune de : 

80 pistes composees d'un nombre variable de secteurs soit pour la 



pistes ^ 15 
pistes 16 ^ 31 
pistes 32 h 47 
pistes 48 a 63 
pistes 64 ^ 79 

Chaque secteur a la structure suivante : 

Marque d'adresse : D5 AA 96 

Num^ro de piste sur un octet code en 62 

Numero de secteur «» 

Numero de la face 

Type de format sur un octet 

Checksum 

Marque de fin DE AA 

Gap de 5-10 octets FF synchronises 

Marque de donn^e : D5 AA AD 

Numero du secteur sur un octet 

Donnees 

Checksum 

Marque de fin DE AA FF 

Gap 



12 secteurs 
11 secteurs 
10 secteurs 
9 secteurs 
8 secteurs 
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Pour I'organisation des fichiers sur les disquettes, disque Prodos et 
GS/OS se reporter k la partie sur le GS/Ob. 



3.2 L'acces via Prodos - GS /OS 

Cette methode est celle k preferer, car la plus independante du 
peripheriaue. En effet on accede exactement de la meme facon h une 
carte RAM emulant un disque, qu'^ un disque dur. 

De cette mani^re on accede h des BLOCS, soit en general 512 octets, 
chaque peripherique etant divise en un certain nombre de blocs. 

3.2.1 Prodos 8 

Deux commandes du MLI (Machine Language Interface, ou Interface 
language machine) permettent d'acceder aux blocs : 

READ_BLOCK code $80 Lecture d'un bloc. 
WRITE_BLOCK code $81 Ecriture d'un bloc 

READ_BLOCK : 
WRITE_BLC)CK : 

Ces fonctions appellent le «device handler» d'une unite donn^ pour 
la lecture ou I'ecriture d'un bloc de 512 octets. L'appel h cette fonction 
est equivalent h l'appel direct du «device handler» en ayant respecte 
les conditions d'entr^es suivantes : 

•La validite du buffer est verifiee. 

•Les interruptions sont inhibees. 

•Le numero d'unite est verifie. 

•La carte langage est validee, et restauree dans son ^tat initial. 

Liste de param^tres : 

+0 $03 

+1 numero d'unite sous la forme DSSSOOOO ou 

D est le numero de Drive et SSS le numero de slot. 
+2/3 Adresse du buffer de donnee 

+4/4 Numero du bloc. 

Code erreur retourne dans I'accumulateur. 
Le bit de carry est positionne en cas d'erreur. 

copyright Too/box 1990 161 



Code Description de Terreur : 

$00 Pasd'erreur. 

$04 Nombre de param^tres different de $03. 

$27 Erreur d'E/S ou numero de bloc 

invalide. 
$28 Pas de peripherique correspondant k 

cette unite. 
$2B Le disc^ue est protege en ecriture. 
$56 Buffer invalide. 

Exemple : 



MLI 



parm_liste 



EQU 

JSR 
DFB 
DW 
BCS 

JSR 

DFB 

DW 

BCS 



DFB 
DFB 
DW 
DW 



$BF00 

MLI 
$80 

parm_liste 
erreur 

MLI 

$81 
parm_liste 

erreur 



$03 
$60 

donnee 
$0000 



;Lecture du bloc 
;$0000 du drive 1 
;Slot 6 



;Ecriture du bloc 
;$0000 du drive 1 



;Slot 6 



donnee 



DS 



512 



3.2.2 GS/OS 

Quatre fonctions permettent I'acc^s aux unites de stockage : 

$202C DInfo : Permet d'obtenir des informations k propos d'un 
Device connecte au syst^me. 

$202F DRead : Permet de lire un bloc ou plus. 
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H 



+0-+1 


E 


+2- +3 


E 


+4- +7 


R 



$202D DStatus :Pour determiner I'etat d'un Device GS/OS. 

$2030 DWrite : Permet d'ecrire un bloc ou plus. 
E Param^tres en entree. 
R Paramdtres en retour. 

Param^tres de DInfo 

Nombre de param^tres (10) 
Num^ro de reference du Device 
Pointeur sur le buffer devant recevoir le nom du 
Device. 
+8 - +9 R Caracteristique du Device. 

Bit 15 : 1 s'il s'agit d'un disque 

RAM ou ROM 

Bit 14 : 1 si un «device driver» a ete gener^. 

Bit 13 : reserve 

Bit 12 : 1 si le Device est occupe 

Bit 11 : reserve 

Bit 10 : reserve 

Bit 9-8 : Vitesse h laquelle p)eut fonctionner le Device 

00 1 Mhz 

01 2.6 Mhz 

10 > 2.6 Mhz 

1 1 Vitesse sans importance. 
Bit 7:1 si le Device utilise des blocs. 
Bit 6:1 1'ecriture est autorisee 

Bit 5:1 la lecture est autorisee 

Bit 4 : reserve 

Bit 3:1 le formatage est autoris^ 

Bit 2 : 1 le support du Device est amovible 

(ex une disquette pour une unite de disquette) 

Bit 1 : reserve 

Bit : reserve 

Capacite du Device en bloc. 
Numero du slot du Device. 
Numero d'unite du Device pour le Smartport. 
Numero de version du «Device driver» 
Numero d' identification du Device 
Ex : $0000 disquette 5 pouce 1 /4 
$0003 disquette 3 pouce 1 /2 
Premier numero de Device dans la liste. 
Numero suivant de Device 

La liste contient tous les num^ros de Devices en rapport, comme les 
partitions d'un disque dur. 
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+10-+13 


R 


+14-+15 


R 


+16-+17 


R 


+18-+19 


R 


+20-+21 


R 


+??-+23 


R 


+24-+25 


R 



Param^tres de DRead DWrite : 



+0-+1 
+2- +3 
+4- +7 
+8 -+11 
+12-+15 
+16-+17 
+18-+21 



E 
E 
R 
E 
E 
E 
R 



Nombre de param^tres (6) 

Numero de reference du Device. 

Pointeur sur le buffer 

Nombre d'octets k lire / ^crire 

Bloc de depart 

Nombre d octets par bloc 

Nombre d'octets reellement lu/6crit 



Param^tres de DStatus 



+0 - +1 E 
+2 - +3 E 
+4 - +5 E 



+6 -+ 9 R 

+10-+13 E 
+14-+17 E 



Nombre de paramfetres (5) 
Numero de reference du Device. 
Type de requete 

$0000 status du Device 
$0001 param^tre de configuration 
$0002 wait / no wait 
$0003 options de formatage 
$0004 status de la partition 
Pointeur sur le resultat 
Taille theoriaue du resultat 
Taille reelle au resultat 



! 



Exemple d'utilisation de DInfo : 
Affichage de la liste des Devices en ligne 



LDA#1 
STA NumDev 
Encore 

DInfo parm 
BCS 


termine 




LDA 
XBA 
STA 


NomDev 
NomDev 


; Transforme le mot 
; de longueur en octet 


PushPtr 


NomDev+1 


; Debut de la chaine 


_DrawString 




; (fonction Quickdraw) 


JSR 


CRLF 


; passe h la ligne suivante 


INC 
BRA 


NumDev 
Encore 


; tente le numero suivant 
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RTS 




panii 




DW 


10 


NumDev 




DW 


1 


DDW 


nom 


DDW 





DW 





DW 





DW 





DW 





DW 





DW 





nom DW 


35 


IN omuev 
DS 


33 



taille du buffer nom 



3.3 L'acces via le Smartport 

Le logiciel du SmartPort correspond ^ la Rom interne du slot 5. II est 
compost d'une serie de routines contrdlant des periph^riques au 
format caract^re (imprimantes, modem ...) ou au format bloc (disque 
dur, disquette, ...) connectes h la prise disquette du GS (ou inseres 
dans un slot). Ce logiciel transforme les appels en un format intelligi- 
ble par les unites intelligentes ( unitespouvant interpreter des flots de 
commandes circulant sur le Bus du SmartPort, comme par exemple 
I'UniDisk 3.5). De meme le SmartPort foumi une interface pour plu- 
sieurs Devices inintelligentes comme 1' Apple 3.5 , les Ramcards, les 
disques RAM et ROM. 

On trouve aussi une version du SmartPort dans 1' Apple lie et He pour 
le controle de la carte memoire (extension) de 1 Mo et de 1 Unidisk 3.5. 

L'appel du SmartPort ressemble k un appel au MLI de Prodos/8. 
Chaque sequence d'appel consiste en un JSR vers I'entree du Smart- 
Port suivi par I'octet de commande du SmartPort et I'adresse de la 
liste de param^tres. 



Exemple : 



SR 



SmartPort 
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DFB $00 ; Status 

DW Farms 

Les appels au SmartPort existent sous deux formes, une version ne 

germettant les acc^s aue dans le banc $00 (version compatible avec le 
martPort sur He et lie) et une version etendue permettant I'accfes h 
toute la memoire. 



3.2.1 Localisation du SmartPort et de I'adresse d'appel. 

On peut determiner la presence du SmartPort en examinant les octets 
de signature des roms des cartes. 

$Cn01 doit etre egal h $20 
$Cn03 doit etre egal h $00 
$Cn05 doit etre egal k $03 
$Cn07 doit etre egal k $00 

Avec n le numero du Slot, soit pour le logiciel SmartPort en slot 5 du 
GS, $C501, $C503, $C505 et $C507. En effet si on examine k partir du 
moniteur la rom en $00/C500 on obtient la sequence suivante : 



$00/C500 


A2 20 


LDX 


#$20 


$00/C502 


A2 00 


LDX 


#$00 


$00/C504 


A2 03 


LDX 


#$03 


$00/C506 


C9 00 


CMP 


#$00 



Donnant bien les valeurs caracterisant le SmartPort en $C501, $C503, 
$C505, $C507. 

L'adresse d'appel est calculee de la fagon suivante : On additionne la 
valeurtrouveeen $CnFF^$Cn00 (ce qui nous donnele point d'entree 
du «Device handler» de Prodos/8) et on ajoute 3. 

Exemple : 

$C5FF = $0A ce qui donne comme point d'entree du Device Handler 
prodos/8 $C50A et comme point d'entree du SmartPort $C50D. 

3.2.2 Liste des commandes SmartPort 

II y a deux types de commandes pour le SmartPort, les commandes 
normales (heritees de 1' Apple He, lie) et les commandes etendues 
tirant avantage des nouvelles possibilites d'adressage du 65C816. 
(plus de memoire, adressage 16 bits ...). Generalement chaque com- 
mande existe sous les deux formes. 
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Chaque appel au SmartPort h la forme d'un appei au Ml J de Proaos^, 
soit un JSR au point d' entree du SmartPort suivi du code de 1.^ 
commande, et d un pointeur sur ia liste de parametres de la com- 
mande. 

Pour les appels normaux le pointeur est sur deux octets et represt nte 
une adresse dans le banc 00. Pour les appels etendus le pointeur est 
sur 4 octets et reference une liste de parametres d.?ns n'lrp.po'-le quel 
banc. 

Le code d'un appel etendu est egal au code d'un appel normal plus 
$40. 

Exemple : Status normal $00, Status etendu $40 



Les appels au SmartPort subissent les contraintes suivantes : 

On ne peut rien transferer vers ou de la zone se trouvant dans ia Page 
Zero du mode emulation, (soit $00/0000 h $00/OGFF) 

• On doit disposer d'un minimum de 35 octets de pile libre avant 
I'appel du SmartPort. 

• On ne peut appeler le SmartPort qu'^ partir du mode emulation du 
65C816. 

En cas d'erreur lors de I'execution d'une commande le bit carry est 
positionne et un code erreur est transmis dans I'accumulateur. Lors 
de I'execution correcte d'une fonction le bit carry est efface et I'accu- 
mulateur contient 0. 

Si des donnees ont ete transferees d'un Device au CPU on trouve dans 
les registres X et Y leur nombre ( poids fort en Y) 

Note : tous les buffers doivent etre alloues par 1' appelant, avant 
I'appel. 



3.2.3 Commandes 

3.2.3.1 Status : $00 / $40 

Renvoi des informations h propos d'un Device particulier ou si le 
numero d'unit4 est k zero, du SmartPort lui-meme. 
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Param^tres : 

E Fourni en entree R Re<;u en sortie 

E - Nombre de param^tres 1 octet : $03 
E - Numero d'Unite 

(Les num^ros d'unit^ sont alloues de fagon unique k 

chaque Device lors de I'initialisation du SmartPort) 
R - Pointeur sur un buffer devant contenir le r6sultat.(deux 

ou quatre octets suivant mode normal ou ^tendu) 
E - type de status demand^ 

$00 Status d'un Device 

$01 Bloc de controle d'un Device 

$02 Etat du caractere nouvelle ligne 

$03 Bloc d'information d'un Device 

En retour on obtient dans le buffer les informations suivantes : 

Type de status : $00 4-5 octets d' informations :1 octet de status g^n^ral. 

bit 7 ^ 1 : Device de type bloc , 

: Device de type caractere 
bit 6 ^ 1 : Ecriture autorisee 
bit 5 ^ 1 : Lecture autorisee 
bit 4 ^ 1 : Device en ligne ou disquette prdsente. 
bit 3 ^ 1 : Formatage autorise 

bit 2 ^ 1 : Protection en 6criture (Device de type bloc seulement) 
bit 1 ^ 1 : Device en cours d'interruption (Apple lie seulement) 
bit ^ 1 : Device actuellement ouvert (Device de type caractere) 

S'il s'agit d'un Device de type bloc les octets suivants representent le 
nombre de blocs du Device (3 octets pour un appel normal, 4 octets 

Eour un appel ^tendu). 
»ans le cas d'un Device de type caractere, les octets suivants sont h 
zero. 

Si le numero d'unit^ est de zero on obtient les informations sur le 
SmartPort soit 7 octets : 

octet Nombre de devices 

octet 1 Etat d'interruption (si bit 6 k alors pas d'interruption 

octets 2-3 Societe ayant realise le logiciel SmartPort 

$0000 Ind^terming 

$0001 Apple 

$0002 Autre 

octets 4-5 Version de I'lnterface 
octets 6-7 Reserve (doit etre $0000) 
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Type de status : $01 

Le bloc de contrdle est specifique h chaque Device, la seule chose 
commune etant la pr^ence d'un octet de longueur comme premier 
caract^re du buffer. (Note: comme valeur pour cet octet inaique un 
buffer r^sultat de 256 octets et non 0. L' octet contenant la longueur du 
buffer resultat n'est pas compt6 dans celle-ci ). 

Type de status : $02 

Etant donn6 qu'aucun Device de type caract^re n'est encore impl6- 
mente, ce type de status est indefini. 

Type de status : $03 

Cet appel retoume dans le buffer le bloc d'information d'un Device . 

•Status du Device (Idem octet de status g^n^ral) 1 octet. 
•Taille en bloc du device 3 octets si appel normal, 4 octets sinon. 
•Taille de la chaine d'identification 1 octet. 
•Chaine d'identification 16 octets. 
•Octet de type du Device 
•Octet de sous type du Device 

Bit 7 : support du mode etendu 

Bit 6 : support des erreurs de changement de disque 

Bit 5 : Meaia amovible. 

Bit 4 ^ reserves. 
•Mot de version : 2 octets 
Exemple de couples type, sous type definis : 

Type Sous type Device 

$00 $00 Carte d'extension m^moire Apple 

$00 $C0 Carte d'extension m^moire Apple GS configuree 

en disque RAM. 
$01 $00 Unidisk 3.5 
$01 $C0 Apple 3.5 
$03 $E0 SCSI avec Media non amovible. 



3.2.3.2 ReadBlock : $01/$41 
WriteBlock : $02/$42 

Lit/Ecrit un bloc de 512 octets h partir de I'unit^ specifiee en param^ 
tre. Le bloc est lu/^rit vers/^ partir de I'empiacement memoire 
specific en param^tre. 
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Paramdtres : 

E - Nombre de param^tres 1 octet egal h $03 

E - Numero d'unite 1 octet 

ER- Pointeur sur le buffer 2^4 octets 

E - Numero du bloc 3^4 octets. 

Codes d' erreur en retour : 

$06 BUSERR Erreur de communication sur le SmartPort 

$27 lOERROR Erreur d'entree sortie 

$28 NODRIVE Pas de Device connecte 

$2B NOWRITE Disque protege contre I'ecriture 

$2D BADBLOCK Numero de bloc invalide. 

$2F OFFLINE Device offline ou pas de disquette dans I'unite. 



3.2.3.3 Format : $03/$43 

Formate un Device de type bloc. Ce formatage est sans rapport avec 
le syst^me d' exploitation (on installe la structure pistes /secteurs sur 
une disquette, mais pas le catalogue ou la liste des blocs libres), il 

Prepare tous les blocs du Device pour permettre I'ecriture et la lecture, 
aram^tres : 

E - Nombre de param^tres : 1 octet valant $01 
E - Numero d'unite 1 octet. 

Codes d' erreur en retour : 

$06 BUSERR Erreur de communication sur le SmartPort 

$27 lOERROR Erreur d'entree sortie 

$28 NODRIVE Pas de Device connectee 

$2B NOWRITE Disque protege contre I'ecriture 

$2F OFFLINE Device offline ou pas de disquette dans I'unite. 



3.2.3.4 Control : $04 / $44 

Envoi des informations de controle h un Device (demande d'ejection 
de disque ...) la demande peut etre de type general ou specifique k un 
type de Device. 

Param^tres : 

E - Nombre de param^tres $03 
E - Numero d'unite 1 octet 
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E - Pointeur sur la liste de controle 2^4 octets 
E - Type de controle demande. 

Note : les deux premiers octets de la liste de controle sp^cifient sa 

taille. 

Le type de controle depend du Device adress^. 
Les types suivants etant predefinis : 

$00 Reset logiciel du Device. 

$01 Positionnement du bloc de controle. 

$02 Selection du caract^re nouvelle ligne. 

$03 Controle des interruptions. 

Codes d'erreur en retour : 

$06 BUSERR Erreur de comm. sur le SmartPort 

$21 BADCTL Type de controle invalide 

$22 BADCTLPARM Liste de param^tres invalides. 

*op/^ UNDEFINED Erreurs specifiques au Device. 



3.2.3.5 Init : $05 1 $45 

Permet ^ I'application de reinitialiser le SmartPort. 

Param^tres : 

E - Nombre de param^tres $01 
E - Num^ro d'unit6 $00 

Codes d'erreur en retour : 

$06 BUSERR 

$28 NODRIVE 



Erreur de communication sur le 

SmartPort 

Pas de Device connecte 



3.2.3.6 Open : $05 1 $45 

Ouvre un Device de type caract^re en lecture/ecriture. Un Device de 
type bloc recevant cet appel renverra le code BADCMD. 
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Param^tres : 



E - Nombre de param^tres $01 
E - Numero d'unit^ 1 octet 



Codes d'erreur en retour : 



$01 
$06 

$28 



BADCMD 
BUSERR 

NODRIVE 



Commande invalide 

Erreur de communication sur le 

SmartPort 

Pas de Device connecte 



3.2.3.7 Close: $07/ $47 

Cet appel indique h un Device de type caract^re qu'une sequence 

d'Ecriture/Lecture est termini (pour uneimprimante cet appel peut 

demander de vider le buffer d' impression) 

Un Device de type bloc recevant cet appel renverra le code erreur 

BADCMD. 

Param^tres : 

E - Nombre de param^tres $01 
E - Numdro d'unite 1 octet 

Codes d'erreur en retour : 



$01 


BADCMD 


Commande invalide 


$06 


BUSERR 


Erreur de communication sur le 
SmartPort 


$28 


NODRIVE 


Pas de Device connecte 



3.2.3.8 Read: $08/ $48 

Permet de lire un nombre d'octets donne. 

L'adresse reference une localisation sur un device de type caractdre. 

Dans le cas d'un Device de type bloc l'adresse correspond k un 

numero de bloc (cet appel sert dans ce cas h lire des blocs de taille 

dif f^rente de 512 octets comme par exemple les blocs d'une disquette 

Macintosh). 

Param^tres : 
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E - Nombre de param^tres $04 

E - Numero d'unite : 1 octet different de 

E - Pointeur du buffer 2^4 octets 
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E - Nombre d'octets h transferer 2 octets 

(poids faible poids fort) 
E - Adresse dar\s le device 3^4 octets 



Codes d'erreur en retour 

$06 BUSERR 

$27 lOERROR 

$28 NODRIVE 

$2B NOWRITE 

2D BADBLOCK 

$2F OFFLINE 



Erreur de communication sur le 

SmartPort 

Erreur d'entr^ sortie 

Pas de Device connect^ 

Disque prot^g^ contre I'^criture 

Num^ro de bloc invalide. 

Device offline ou pas de disquette dans 

I'unite. 



3.2.3.9 Write: $09/ $49 

Permet d'^crire un nombre d'octets donn^. 

L'adresse r^f^rence une localisation dans un device de type caract^re. 

Dans le cas d'un Device de type bloc l'adresse correspond k un 

num^ro de bloc (cet appel sert dans ce cas h. lire des blocs de taille 

diff^rente de 512 octets comme par exemple les blocs d'une disquette 

Macintosh). 

Param^tres : 

E - Nombre de param^tres $04 

E - Num^ro d'unite : 1 octet different de 

ER - Pointeur du buffer 2^4 octets 

E - Nombre d'octets h transferer 2 octets 

(poids faible poids fort) 
E - Adresse dans le device 3^4 octets 



Codes d'erreur en retour : 

$06 BUSERR 

$27 lOERROR 

$28 NODRIVE 

$2B NOWRITE 

$2D BADBLOCK 

$2F OFFLINE 



Erreur de communication sur le 
SmartPort 

Erreur d'entr^e sortie 
Pas de Device connect^ 
Disque protege contre I'ecriture 
Numero de bloc invalide. 
Device offline ou pas de 
disquette dans I'unite. 
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3.2.3.10 Types de controle de l' Apple 3.5 

II existe sept types de contrdle specifique k I'Apple 3.5. Ceux-ci 
permettent notamment d'^jecter une disquette, de changer le nombre 
de faces (simple ou double face) ainsi que son formatage. 

Les param^tres donn^ doivent se trouver dans la liste de contrdle 
avant I'appel du SmartPort. 

3.2.3.10/1 Eject: $04 

Ejecte la disquette contenue dans le drive. 

E- Taille de la liste 2 octets : $0000 
Exemple : 

En supposant que I'unit^ 1 est un Apple 3.5. 

JSR SmartPort 

DFB $04 ;Control 

DW parm 

BCS Erreur 

parm DFB $03 

DFB $01 

DW parm_ctrl 

DFB $04 ;Code d'^jection 

parm_ctl 

DW $0000 ;taille de la liste 

3.2.3.10/2 SetHook : $05 

Permet de rediriger les routines internes de I'Apple 3.5 vers ses 
propres routines. Ceci permet notamment de lire ou d'ecrire des 
disquettes de format non-standard. 
Param^tres : 

E - Taille de la liste $0004 
E - Num^ro du Vecteur. 

$01 Lecture du champ adresse 

$02 Lecture du champ donn^e 

$03 Ecriture du champ donn^ 

$04 Positionnement tete/ piste 
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$05 Formatage 

$06 Ecriture d'un piste 

$07 Verification d une piste 

Nouvelle adresse du vecteur 
3 octets : Poids faible 
Poids fort 
Num^ro de banc 



3.2.3.10/3 ResetHook : $06 

Restore la valeur par defaut d'un vecteur. 

Param^tres : 

E - Taille de la liste $0001 

E - Num^ro de reference du vecteur 



3.2.3.10/4 SetMark:$07 

Change des octets dans la table des marques (marques de champ 
adresse, donn^e ...) 

Param^tres : 

E - Taille de la liste 1 octet 

E - Debut des modification dans la table 1 octet 

E - Octets modifies 



Table 





1^4 

5^9 

10^12 

13^17 

18^21 



Numero de secteur $FF 
Marque de champ donn^ $AD $AA $D5 $FF 
Octets de synchro $FC $F3 $CF $3F $FF 
Fin de donnee/ adresse $FF $AA $DE 



gap $FF $FF $FF $FF $FF 



arque de champ adresse $96 $AA $D5 $FF 



Exemple : on change la marque de champ adresse en $D5 $AA $97 



JSR 
DFB 
DW 
BCS 



SmartPort 

$04 



;Control 



>arm 
irreur 
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parm 



parm_ctl 



DFB $03 

DFB $01 

DW parm_ctrl 

DFB $07 



DW $0004 

DFB 18 

DFB $97,$AA,$D5 



f 



;Code d'^jection 



;taille de la liste 



3.2.3.1 /.5 ResetMark : $08 

Permet de restaurer la valeur par d^faut des param^tres de la table. 

Param^tres : 

E - Taille de la liste 1 octet ^gal au nombre d'octets 

h restaurer dans la table plus 1. 
E - Octet de depart dans la table 1 cxrtet 

Exemple : on restore la marque de champ adresse 



parm 



parm_ctl 



JSR 
DFB 
DW 
BCS 


SmartPort 
$04 
parm 
Erreur 


;Control 


DFB 
DFB 
DW 
DFB 


$03 
$01 

parm Ctrl 
$08 


;Code d'^jection 


DW 
DFB 


$0004 
18 


;3 octets h restaurer 
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3.2.3.10/6 SetSides : $09 

Defini le nombre de faces de la disquette. 

Paramfetres : 

E - taille de la liste $0001 
E - Nombre de faces 1 octet 

$80 2 faces 

$00 1 face 

3.2.3.10/7 Setlnterleave 

Defini rentrelacement des secteurs, pour la prochaine operation de 
formatage. 

Param^tres : 

E- Taille de la liste $0001 

E - Entrelacement $01 h $0C un octet 

Avec un entrelacement de 1 on a la disposition suivante des secteurs 
sur le disque : 

$0$1$2$3 $C 

avec un entrelacement de 2 on saute un secteur sur 2 

$0 $6 $1 $7 $2 $8 $3 $9 $4 $A $5 $B $6 $C 



3.4 L'Acces via les devices handlers de Prodos 8 

ProDOS/8 contrairement au DOS 3.3, est independant des periph^ 
riques, mais necessite pour permettre leur utilisation un Device 
handler, equivalent de la RWTS du DOS 3.3. Ce device handler existe 
en standard pour les unites 5 1 /4 et pour le volume /RAM, de meme 
ce device handler est ^efini gn Rom pour le disqug dur Profile et leg 
Apple 3.5 et Unidisk 3.5. 

Ces devices handlers sont utilises par le MLI et permettent d'acc^der 
de fa(;on adequate aux peripheriques. Ces handlers peuvent suppor- 
ter quatre fonctions de base : FORMAT, READ, WRITE, STATUS. 
(Tous les handlers ne supportent pas I'integralite de ses fonctions, 
notamment le driver pour le Disk n ne supporte pas la fonction 
FORMAT.) 
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Les appels READ BLOCK et WRITE BLOCK du MLI sont la m^thode 

germettant d'acc^der aux blocs h partir de ProEXDS comme les appels 
•Info, DStatus, DRead, DWrite pour Gs/OS, mais il est ^galement 
possible d'acc^der directement (totalement conseill^) au device han- 
dler. 

L'adresse des devices handlers se trouvesous ProDOS/8 dans la page 
globale de $BF10 h $BF2F. (par exemple pour appeler le device 
handler du slot 6 drive 1 on fait un JSR ($BF1C)). Le passage de 
param^tres aux devices handlers se fait via des emplacements en 
page zero : 

$42 Code de la commande 

$43 Num^ro d'unite sous la forme DSSSOOOO 

D numero de Drive 

SSS numero de slot 

$44-$45 adresse du buffer 
$46-$47 numero du bloc. 



3.4.1 Status : $00 

Cet appel retoume I'etat d'un Device particulier. Generalement il est 
utilise pour determiner si un Device est present et s'il est prot^g^ en 
ecriture ou non. Certains handlers retoument en plus le nombre de 
blocs support^s par le Device. 

$42 Doit etre $00. 

$43 Unit4 concernee. 

$44 - $45 Inutilise. 

$46 - $47 Inutilis^ doit etre h $0000 

En retour le bit carry est positionne en cas d'erreur et I'accumulateur 
contient le code erreur : 

$00 Pas d'erreur. 

$27 Erreur d'Entree sortie 

$28 Pas de Device connecte h cette Unit^. 

$2B Disque proteg^ en ecriture. 



3.4.2 Read : $01 

Cet appel lit un bloc de 512 octets et le stocke en m^moire ^ I'empla- 

cement specific. 

Aucun test n'est effectue sur la validite de l'adresse destination, done 

prudence. 
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$42 Doitdtre$01. 

$43 Unite concernee. 

$44 - $45 Adresse de destination. 

$46 -$47 Numero du bloc. 

En retour le bit carry est positionne en cas d'erreur et I'accumulateur 
contient le code erreur : 

$00 Pas d'erreur. 

$27 Erreur d'Entree sortie 

$28 Pas de Device connect^ k cette Unit6. 

$2B Disque prot^g^ en ecriture. 



3.4.3 Write : $02 

Cet appel 4crit un bloc de 512 octets h partir de Templacement 
m^moire specific. 



$42 
$43 

$44 -$45 
$46 -$47 



Doit etre $02. 
Unit6 concernee. 
Adresse source. 
Numero du bloc. 



En retour le bit carry est positionn^ en cas d'erreur et I'accumulateur 
contient le code erreur : 

$00 Pas d'erreur. 

$27 Erreur d'Entree sortie 

$28 Pas de Device connecte k cette Unite. 

$2B Disque proteg4 en ecriture. 



3.4.3 Format : $03 

Cet appel formate le media dans I'unite specific. II s'agit comme dans 
le cas des appels SmartPort Juste d'un forma tage bas niveau, les 
structures de fichiers de ProDOS (catalogue, bit map) ne sont pas 
installees. 



$42 
$43 

$44 -$45 
$46 -$47 



Doit §tre $03. 
Unit^ concernee. 
Inutilise. 
Inutilise. 



copyright Toolbox 1990 ITS 



En retour le bit carry est f)Osition6 en cas d'erreur et I'accumulateur 
contient le code erreur : 

$00 Pas d'erreur. 

$27 Erreur d'Entr^ sortie 

$28 Pas de Device connecte k cette Unit6. 

$2B Disque prot^g^ en 4criture. 

Exemple : 

Recopie du bloc $0001 sur le bloc $0000 pour le floppy en 
slot 6 drive 1 



STA 



$C080 



;valide la carte langage 



LDA 
STA 


#$01 
$42 


;READ 


LDA 

STA 

LDA 

STA 

LDA 

STA 


#%01 10000 

$43 

#<buffer 

$44 

#>buffer 

$45 


;Unite 

;adresse du buffer 


LDA 

STA 

LDA 


#01 
$46 
#00 


;num^ro du bloc 
;poids faible 


JSR 


call 




BCS 


erreur 




LDA 
STA 
LDA 
STA 


#$02 

$42 

#%01 10000 

$43 


;WRITE 
;Unite 


LDA 

STA 

LDA 

STA 

LDA 


#<buffer 

$44 

#>buffer 

$45 

#00 
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STA 

LDA 

STA 


$46 
#00 

$47 




JSR 


call 




BCS 


erreur 


call 


JMP 


($BF1 


buffer 







;Adresse dans la page 
;globale 



DS 



512 



3.5 L'Acces direct aux disquettes 

Via les commutateurs logiciels situes en $COOO/$COFF il est possible 
de simuler enti^rement les Devices handlers de ProDOS/8. L'acc^ 
aux unites de disquettes via cette n\4thode est extremement d61icat, 
car il suffit d'une petite erreur de programmation pour effacer d^fini- 
tivement le contenu d'une piste. En contre partie cette methode laisse 
une liberte totale (dans la limite des capacity du lecteur de disquettes) 
quant k I'organisation des informations sur le disque, d'ou son emploi 
intensif par les programmes de copie et les syst^mes de protections. 



3.5.1 Le lecteur 5 1/4 

16 commutateurs logiciels (softs witches) permettent I'acc^s aux dis- 
ques 5 1 /4. Huit autres controlent le deplacement de la tete , 8 autres 
contrdlent la lecture /ecriture, la selection de I'unite et la mise en 
marche du moteur. 



Phase 


$C0E0 


Off 


$C0E1 


On 


Phase 1 


$C0E2 


Off 


$C0E3 


On 


Phase 2 


$C0E4 


Off 


$C0E5 


On 


Phase 3 


$C0E6 


Off 


$C0E7 


On 



Selection du Drive 1 $C0EA 

Selection du Drive 2 $C0EB 

Mise en route du moteur $C0E9 

Arret du moteur $C0E8 

Q6 $COEC Off $COED On 

Q7 $COEE Off $COEF On 
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3.5.1.1 Deplacement du bras 

Chacune des phases doit etre accedee sequentiellement pour d^pla- 
cer le bras (Mise On puis Off)- Dans un ordre ascendant, ^ 3 le bras 
se deplace vers les pistes superieures, dans I'ordre inverse le bras se 
d^place vers la piste 0. 

Pour se deplacer d'une piste entiere, il faut acceder k deux phases. 
L'acc^s h une seule phase ne d^placant le bras que d'une demi piste. 

Pour I'obtention de performances optimum le d^lai entre I'allumage 
et I'extinction des phases, est critique. II faut laisser le temps au bras 
de se positionner sur la piste suivante, sans lui laisser le temps de s'y 
arreter, (pour profiter de son 41an) s'il ne s'agit pas de la piste voulue. 

De meme un delai suf fisant doit etre prevu pour permettre la prise de 
Vitesse du moteur du drive apr^s sa mise en route. 

SEEK 

en entr^ n de piste souhaitee fois 2 
01d_Trk piste actuelle 
X slot fois 16 soit $60 



LAD 



Inf 
LC5 
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STX 


Slot Nb 


STA 


$2A 


CMP 


Old Trk 


BEQ 


LFC 


LDA 


#$00 


STA 


$26 


LDA 


Old Trk 


STA 


$27 


SEC 




SBC 


$2A 


BEQ 


Fin 


BCS 


Inf 


EOR 


#$FF 


INC 


Old Trk 


BCC 


LC5 


ADC 


#$FE 


DEC 


Old Trk 


CMP 


$26 


BCC 


LCB 



; On est dejk sur la piste 



LCB 


LDA 

CMP 

BCS 


$26 

#$0C 

LDO 


J 


LDO 


TAY 
SEC 




^^H 




JSR 


Movel 


^^^^^^1 




LDA 
JSR 


TblTmpl,Y 
Wait 


ni^^H 




LDA 

CLC 

JSR 


$27 
Move 11 


^9 




LDA 

JSR 

INC 

BNE 


TblTmp2,Y 
Wait 
$26 
LAD 


"^ 


Fin 


JSR 


Wait 


^1 


Movel 
Mo veil 

LFC 


CLC 
LDA 
AND 
ROL 
ORA 
TAX 
LDA 
LDX 
RTS 


Old Trk 
#$03 
A 
Slot.Nb 

$C080,X 
$2B 


1 


; Routine d^lai lors du d^placement 
; A contient le nombre de 100 Usee k 
; attendre 


I 


Wait 
L02 


LDX 
DEX 
BNE 
BSfC 
BNE 


#$11 

L02 
$46 
LOB 


;routine de temporisation ^^H 
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INC 


$47 


SEC 




SBC 


#$01 


BNE 


Wait 


RTS 





LOB 



; Valeurs d'intervales de 100 Usee utilises 
; lors du deplacement du bras. 



TblTmpl DC 
TblTmp2 DC 



H'01302824201E1D1C1C1C1C1C' 
H'702C26221F1E1D1C1C1C1C1C' 



3.5.1.2 Allumage extinction du moteur 

$C0E9 Allumage du moteur 
$C0E8 Extinction du moteur 

Un d^lai suffisant doit etre laisse avant toute autre operation pour 
permettre au moteur d'atteindre la bonne vitesse (SOOtpm). Pour ceci 
on peut employer une routine de delai fixe ou une routme surveillant 
le registre ae donn^e. 



Exemple : 








Extinction du moteur. 








LDX 


#$60 






LDA 


$C088,X 






LDA 


$C08E,X 




L25 


LDY 


#$08 






LDA 


$C08C,X 


; h I'arret le contenu 
; du registre de donnee 
; est constant 


L2A 


CMP 


$C08C,X 






BNE 


L25 






DEY 








BNE 


L2A 





3.5.1.3 Selection du drive lou2 

$COEA S^lectionne le Drive 1 
$COEB S^lectionne le Drive 2 
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3.5.1.4 Lecture d'un Octet 

On doit avoir precedemment accede k $COEE pour valider le mode de 
lecture. 



loop 



LDA 

LDA 
BPL 



$COEE 

$COEC 
loop 



Tous les octets valides ont le bit de poids fort k 1 (octet de $80 h $FF) 



3.5.1.5 Detection de la protection en ecriture 



LDA 
LDA 
BMI 



3.5.1.6 Ecriture d'un octet 

LDX 

STA 

JSR d^lai 

LDA 

STA 

ORA 



$COED 
$COEE 
Prtg 



#$60 
$C08F,X 



; la valeur dans $COEE est 
; sup^rieure h $80 si protg 



; Mode Ecriture 
; D^lai de lOOmsec 
#$AA 

$C08D,X ; Charge le registre 
$C08C,X ; Commence 1 ecriture 



Pour ecrire un octet, on doit commencer par charger la valeur k ecrire 
dans le registre de donn^ ($COED) puis acceder k $COEC pour 
d^lencherl' Ecriture. L' automate controlant le disque ecrit un bit tous 
les 4 cycles. Le bit 6crit est le bit de poids fort de $COED le registre est 
dealer ensuite automatiquement aun bit vers la gauche ( $FF devient 
$FE). 

On doit done ecrire les octets en 32 cycles exactement. A noter que les 
cycles sont comptes en vitesse lente soit IMHz. 
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Exemple d'ecriture en 32 cycles de la marque du champ donnee d'un 
secteur : 

NB cycle de I'instruction 
Calcul total 
cycle entre le 
$D5 et le $AA 



write 



LDA 


#$D5 


2 






JSR 


write 


6 






LDA 


#$AA 


2 


10 




JSR 


write 


6 


12 




LDA 


#$AD 


2 






JSR 


write 


6 






CLC 




2 


18 




PHA 




3 


20 




PLA 




4 


23 




STA 


$C08D,X 


5 


27 




ORA 


$C08C,X 


4 


32 


; Debut de I'ecriture 
; du $D5 



RTS 6 4 

Note : II existe un deuxi^me type d' octets, les octets de synchronisa- 
tion. Ceux-ci permettent au controleur de se positionner dans le flux 
de bits composant une piste. Ces octets sont ecrits en 40 cycles. Les 8 
cycles suplementaires generant 2 bits k permettant cette synchroni- 
sation. 

Soit une chaine de $FF 4crite comme octets de synchro. Suivi d'un 
octet valant $AA 



$FF $FF $FF $AA 

1111 1111 00 1111 1111 00 1111 1111 00 1010 1010 



t 



La lecture commence ici 
1111 00 1 $F9 

11111110 $FE 



Skip un octet valide 
commence par un 1 
1111 1111 $FF 
On est synchronise 
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Premier octet lu (Rappel le bit de poids fort doit §tre ^1) 

1111 1001 $F9 

Octet suivant : $FE 
Octet suivant : $FF 
On lit correctement le $AA suivant 

Cas ou les $FF ne sont pas des octets synchros. 

1111 1111 1111 1111 1111 1111 1010 1010 




t 



La lecture commence id 
1111 111 $FF 

1 1111 111 $FF 

1 1111 101 $FD 

On ne lira pas le $AA correctement. 

On peut se demander pourc^uoi on n'ecrit pas tout simplement une 
chame de zero avant toute mformation valide. La raison est toute 
simple, la presence de plusieurs bits h z^ro cons^cutifs sur le disque 
est tres mal supporte par I'automate qui relit une valeur aleatoire. 



3.5.2 Le lecteur 3 "1/2 




1' 

que I'Unidisk 3.5 dispose de son propre processeur 

propre RAM/ROM. 

Le drive 3.5 utilise les m^mes commutateurs logiciels que le drive 
5 1 /4. On doit done le selectionner avant toute chose car le 5 1 /4 est 
valide par def aut. 

Pour selectionner le Drive 3.5 on doit effectuer les operations suivan- 
tes : 

• Valider les slots internes en 5 et 6 du GS 

LDA $C02D 

AND #$9F 
STA $C02D 
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• Etre en vitesse rapide, et ne pas repasser en vitesse lente au demar- 
rage du moteur 

LDA $C036 

AND #%11111011 ; Pas de passage en vitesse lente 

; sur mise en marche du mo 

; teur 
ORA #$80 

STA $C036 

• Ecrire un $40 en $C031 pour selectionner le 3.5, tete 



3.5.2.2 Allumage extinction du moteur 



$C0E9 Allumage dli moteiir 

$C0E8 Extinction du moteur 



3.5.2.3 Selection du Drive 1 ou2 

$COEA Selectionne le Drive 1 
$COEB Selectionne le Drive 2 



3.5.3 Registres propres au 3.5 

Le registre d'interface disque : 

Permet de selectionner le lecteur 5 1 /4 ou le drive 3 1 /2, permet pour 
ce dernier de selectionner la tete adressee pour les operations de 
lecture ecriture. 

Bit 7 ^ 1 selectionne la tete 1 
k selectionne la tete 

Bit 6 & 1 selectionne les drives 31/2 
h selectionne les drives 51/4 

Le lecteur 31/2 utilise aussi les memes commutateurs logiciels que le 
lecteur 5 1 /4. Ces commutateurs situ^s de $COEO k $COEF portent les 
memes noms que lors de leur emploi pour le 51/4 mais par contre 
leur fonction est totalement differente. 

En effet les commutateurs Q6 h Q7 de concert avec la mise en marche 
du moteur permettent d'acc^der h cinq registres differents. 
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Off 


Off 


On 


Off 


On 


XX 


On 


Off 


XX 


On 


On 


Off 


On 


On 


On 



Q7 Q6 Moteur Operation 

lecture registre de donnee 
lecture registre de status 
lecture registre handshake 
dcriture registre de mode 
ecriture registre de donnee 

Apr^s selection d'un registre, I'ecriture h n'importe quelle adresse 
impaire de I'lWM ($C0E1 ^ $COEF) ecrira dans ce registre, la lecture 
d'une adresse paire de I'lWM ($COEO h $COEE) lira ce registre. 

Registre de Mode : 

Attention le lecteur doit etre arrete et non seulement eteint. 

Bit 7 Reserve ne pas modifier 
Bit 6-5 Reserve 4crire toujours 
Bit 4 Vitesse de I'horloge de lecture 

1 : ZMhz valeur pour le Gs 

: 8Mhz 
Bit 3 1 : Les cellules de bits de I'octet font 2 Usee cas des 

lecteurs 3.5 

: Les cellules bits de I'octet ont une longueur de 4 

Usee, valeur 

utilis6e pour les Devices connectes au SmartPort et 

les lecteurs 5 1 /4. 
Bit 2 si & 1, le lecteur apr^s sa deselection, restera allume 

une seconde. 
Bit 1 ^1 protocole de Handshake synchrone 

(lecteur 5 1 /4) 

h. protocole de Handshake asynchrone (autres cas) 
Bit 1 : Mode latch valide, la donn^ reste valide pour la 

duree d'un octet. ( cellule de 2 Usee alors 16 Usee, 

cellule de 4 microsec alors 32 Usee) 

: Mode latch invalide, la donnee lue 

reste valide pendant 7 Usee. 

Le registre de Status : 

Bit 7 test de la protection ecriture, (lecteur 51/4) resultat 

acc^s registre pour le 3 1 /2. 
Bit 6 Reserve 
Bit 5 1 : le lecteur 1 ou 2 est selectionne et le moteur est 

allum^. 

: pas de lecteur selectionn^ 
Bit 4-0 Idem registre de mode. 
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Le registre de Handshake : 

Bit 7 1 le registre de donnas est pret pour les donnas. 

le registre de donnas est plein. 
Bit 6 1 le dernier octet ^crit h ^t6 ecrit correctement. 

un octet k ete rate et non ^crit sur le disque. 
Bit 5-0 R^serv^. 

Le registre de donn^ : 

Suivant I'^tat des commutateurs Q7 Q6 on acc^e a I'octet lu h partir 
du disque, ou on ecrit un octet sur le disque. 

Un deuxi^me jeu de registres peut etre accede grace aux commmuta- 
teurs correspondant aux phases, et h la selection de la tete. (SEL) 
Lecture de ces registres : 



Q7 doit etre Off et Q6 On le lecteur doit dtre valide avec le moteur 




^^v.i ,.»»,_^i«v. v^.. ^^^^ w.^ . ....V.....V. -w ^.. ^^ poids — 

$COEE. Apr^s lecture du registre on peut acc^der h un autre registre 
simplement en repositionnant les phases et SEL. A- la fin des opera- 
tions de lectures ae registres, repassez en mode normal en accedant 
h Q6 off. 

Phase2 Phasel PhaseO SEL Registre 

DIRTN direction t§te 
CSTIN Presence d'une disquette 
STEP 
WRTPRT protection ecriture 
MOTORON moteur en marche 
TKO tete sur piste 
TACH tachom^tre 
RDDATAO flot donnees tete 
RDDATAl flot donnees tete 1 

SIDES lecteur simple ou double face 
DRVIN lecteur install^ 

Ecriture dans ces registres : 

Verifiez d'abord c[ue Phase3 est off, ensuite passez On PhaseO et 
Phase2, puis positionnez SEL h 0. Mettez ensuite Phasel et PhaseO 
dans I'etat necessaire pour acc^der aux registre, et positionnez PhaseZ 
suivant la valeur k ecrire (On pour 1, Off pour 0). 
Maintenez Phase3 k On, pendant aux moins 1 Usee, mais moins de 1 
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Off 


Off 


OffO 


Off 


Off 


Offl 


Off 


Off 


OnO 


Off 


Off 


Onl 


Off 


On 


OffO 


Off 


On 


Offl 


Off 


On 


Onl 


On 


Off 


OffO 


On 


Off 


Offl 


On 


On 


OffO 


On 


On 


Onl 



msec (sauf si vous ejectez une disquette) puis remettez le h Off. Soyez 
sfir que vous ne changer ni Phasel-2 ou SEL pendant que PhaseS est 
On, et que PhaseO et Phasel sont On avant de modifier SEL. 

NOTE : Comme dans le cas d'une lecture le lecteur doit dtre d'abord 
s^lectionne. 



Phasel PhaseO 



SEL 



Registre 



Off 
Off 
On 
On 



OffO 
OnO 
OffO 
OnO 

DIRTN: 



CSTIN 



STEP 



WRPTR 
MOTORON 



DIRTN Sens de deplacement de la tete 

STEP Deplace la tete d'une piste 

MOTORON allume le moteur 

EJECT ^jecte le disque. 

indique le sens de deplacement de la tete & 1 on se 
deplace vers la piste 0, ^ vers la piste 79. 

A comme valeur quand une disquette se trouve 
dans le lecteur. 

Mettre ce registre h cause un deplacement de la 
tete en fonction de DIRTN. Quana le deplacement 
est termini (k peut pres 12 msec) le lecteur remet 
STEP ^ 1 et on peut recommencer. 

^ si le disque est protege contre I'ecriture. 

allume le moteur 1 1'eteind. Ne fonctionne que si 
le drive est selectionne et qu'une disquette est 
presente. 



TKO : ^ si la tete se trouve sur la piste 0. 

EJECT : ecrire 1 dans ce registre ejecte la disquette. Atten- 
tion il faut maintenir Phase3 On pendant au moins 
1 /2 seconde. 



RDDATAO 
RDDATAl 



SIDES 
DRVIN 



donne le flot de bits instantane venant de la t§te 1 
ouO. 

1 car lecteur double faces. 

si un lecteur est connect^. 
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Example d'acc^s aux lecteur : 
Ejection d'une disquette lecteur 1 



LDA 
AND 
ORA 
STA 


$C036 
#$FB 
#$80 
$C036 




LDA 

AND 
STA 


$C02D 

#$9F 

$C02D 




LDA 
STA 


#$40 
$C031 




; Selection du drive 






LDA 
LDA 
JSR 


$COEA 

$C0E9 

Wait 


;Attente 


LDA 
LDA 
LDA 
LDA 

STA 


$C0E6 

$C0E1 

$C0E3 

#$40 

$C031 


;Phase3 Off 
;PhaseO On 
;Phasel On 

;SEL h 


; Param^tres pour 1' 


ejection 




LDA 
LDA 
LDA 


$C0E1 
$C0E3 
$C0E5 


;PhaseO On 
;Phasel On 
;Phase2 On (valeur 1) 


LDA 

JSR 

LDA 


$C0E7 
WAIT 
$C0E6 


;Phase3 On 

;attente d'une demi sec 

;Phase3 0ff 



Deplacement du bras 

*SEEK 

* Allume le moteur et se deplace vers une piste 

* Cyl : Piste voulue 

* CuiCYl : piste actuelle 

* Drive : Lecteur concern^ 
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SEEK 


LDX 

BIT 

BPL 


Drive 

CurCylX 

no 




I 


no 


JSR 

BCS 

JSR 


Recall 
erreur 
DriveOK 


;Recalibre 


I 




SEC 

LDX 

LDA 

SBC 

BEQ 


Drive 
CurCylX 

fin 


;Calcul le nbr de 
;pistes k deplacer 


1 






H 




LDY 

BCS 

LDY 

EOR 

ADC 


#$01 

inf 

#$00 

#$FF 

#$01 


;Piste plus petite 
;No pst plus grand 


1 


inf 


TAX 
TYA 
JSR 

JSR seek. 


EcrREG 

.n 


;Sens de deplace- 
;ment 


1 


fin 


LDX 

LDA 

STA 

CLC 

RTS 


Drive 

Cyl 

CurCylX 




1 


erreur 


LDA 
ORA 
STA 
RTS 


#$02 
Error 
Error 




1 


seek_n 


LDA 
JSR 


#$04 
EcrREG 


;Registre SEEK 


1 


Loop 


JSR 
BPL 
DEX 
BNE 


LitREG 
Loop 

seek_n 


;attente fin de seek 
;encore une piste 


s 




_ 
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tmp 



DriveOk 



Ok 



Wait 



Wait2 



LI 



L2 
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LDX 


#$3C 


' 


DEX 
BNE 
RTS 


tmp 




LDA 

STA 

LDA 

STA 


#$00 
$6A 
#$5D 
$6B 




LDA 

JSR 

BPL 


#$08 

LitReg 

Ok 


;MOTORON 


JSR 


Ecr2Reg 




LDX 
LDA 
JSR 


Drive 
$11,X 
Wait 




LDA 

STA 

JSR 


#$19 

$11,X 

Wait 





RTS 



PHA 

JSR 

PLA 


Wait2 


STA 

LDA 

PHA 

AND 

STA 


$18 
$C036 

#$yE 

$C036 


LDA 
STA 


#$C8 
$17 


DEC 
NOP 


$17 



;Tempo en vitesse 
;lente 



Recall 



encore 



BNE 


L2 


DEC 


$18 


BNE 


LI 


PLA 




STA 


$C036 


RTS 




LDA 


#$01 


JSR 


EcrReg 


LDX 


#$50 


JSR 


seek_n 


LDX 


#$50 


LDA 


#$07 


JSR 


Wait2 


LDA 


#$0A 


JSR 


LitReg 


BPL 


fin 


DEX 




BNE 


encore 


SEC 




BRA 


fin2 



fin 
fin2 



CLC 



LDX 


Drive 


STZ 


CurCylX 


RTS 




; Lecture d'un registre 




LitREG 




JSR 


SetReg 


BIT 


$COED 


LDA 


$COEE 


RTS 




; Ecriture d'un registre 




EcrREG 




JSR 


SetReg 


Ecr2REG 




BIT 


$C0E7 


BIT 


$C0E6 



;TKO 



;Phase3 On 
;Phase3 Off 
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RTS 



Suivant I'etat des bits poids faible de A 

gositionne les Phases et SEL 
it : Phase2 1 = ON 
Bit 1 : SEL 1=1 
Bit 2 : PhaseO 1 = ON 
Bit3:Phasel l=ON 



SetReg 



BIT 


$COEO 


BIT 


$C0E3 


BIT 


$C0E6 


BIT 


$C0E4 


LSR 




BCC 


pasPhase2 
$C0E5 


BIT 


pasPhase2 

LSR 




PHA 




LDA 


$C031 


AND 


#$7E 


BCC 
ORA 


pasSEL 
#$80 


pasSEL 

STA 


$C031 


PLA 




LSR 




BCC 


pasPhaseO 
$C0E1 


BIT 


pasPhaseO 

LSR 




BCC 


pasPhasel 
$C0E2 


BIT 


pasPhasel 

RTS 




Ecriture d'un octet 




HEF03 BIT 


$COED 


LDA #$FF 


STA 


$COEF 


LDY #$07 


Loop 
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LDA : DATA_S2,Y ;Marque de champ 

;donnee 



;On regarde le registre de Handshake 



LI BIT 


$COEC 


;On peut ecrire ? 


BPL 


LI 




STA 


$COED 


;Ecrit 


DEY 






BPL 


Loop 




; Marque d'adresse 






DATA S2 






HEX 


AD 




HEX 


AA 




HEX 


D5 




HEX 


FF 




HEX 


FC 




HEX 


F3 




HEX 


CF 




HEX 


3F 




HEX 


FF 




HEX 


FF 





FF 3F CF F3 FC ecrit des octets de synchro : 

En effet, I'ecriture de cette chaine donne la sequence suivante : 

1111 1111-0011 1111-1100 1111-1111 0011-1111 1100 

Ce qui h la lecture, le controleur ne pouvant lire que des octets ayant 

le bit de poids fort ^ 1, est relue comme : 

1111 llll(sauteles2 0) 

11111111 (saute les 2 ) soit quatre $FF 

Note : Cette methode utilise le registre de Handshake, indiquant la 

possiblite d'ecriture d'un octet. II est egalement possible d'ecrire en se 

synchronisant en 16 cycles comme pour le lecteur 5 1/4. 



lecture d'un octet. 






BIT 


$COEC 


;Mode Lecture 


Loop LDA 
BPL 


$COEE 
Loop 
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GRAPHISME 



Le G de GS signifie «GRAPHISME». Avec le GS, Apple nous a offert 
de nouvelles possibilites, puissantes sur certains points, limitees sur 
d'autres. Je vais essayer de d^crire ici les differentes innovations d'un 
point de vue «FIRMWARE», c'est k dire en restant le plus proche 
possible du hardware. Beaucoup d'ouvrages traitent dej^ de la pro- 
grammation pratique avec les TOOLS (la boite k outils), mon but est 
de rediger un guide de reference et surtout de programmation du 
hardware directement, seul moyen, k mon avis, d'atteindre une 
Vitesse d'execution acceptable sur GS. 

La partie programmation ressemblera k un dialogue dans lequel tous 
les points importants seront analyses. J'utiliserai la langue anglaise 
pour les termes techniques, dans un esprit d'uniformite avec les 
ouvrages americains. 

Tous les exemples de (courts) programmes presentes dans cet ou- 
vrage sont en assembleur. 

Un minimum de connaissance de ce langage est requis, mais le niveau 
reste assez simple et les commentaires sont nombreux. Ces program- 
mes sont assemblables directement avec MERLIN 16 (tm ROGER 
WAGNER PUBLISHING) sous PRODOS 8, mais peuvent certaine- 
ment etre adaptes sans peine pour un autre assemoleur. 
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4.1 Nouvelle resolution graphique (Super-hires) 

Cette resolution est de 320 ou 640 pixels de large par 200 lignes. Seize 
couleurs par ligne peuvent etre utilisees dans ces 2 modes, avec plus 
ou moins de restrictions. 32K de memoire sont alloues pour ce mode 
graphique, h une adresse fixe: de $E12000 h $E19FFF. 

A chaque ligne d'^cran correspond un byte appele SCB (Scan Line 
Control Byte), ce byte definit 4 param^tres pour la ligne en question 

1 . La rfeolution horizontale de la ligne en question (320 ou 64(5 points) 

2. Quelle palette de couleurs est utilisee pour cette ligne (16 palettes 
definissables) 

3. Si une interruption IRQ doit etre gen^ree lors du rafraichissement 
de la ligne 

4. Si le mode fill (remplissage) est actif ou non 



4.1.1 Structure d'un SCANLINE CONTROL BYTE (SCB) 



Bits 0-3 : Numero de la palette assignee 

Bit 4 : Reserve (mis h 0) 

Bit 5 : Mode fill (l=on, O=off) 

Bit 6 : Interruption (l=reclamee, O=non reclamee) 

Bit 7 : Nb de pixels horizontaux (0=320, 1=640) 

La table contenant tous les SCB commence en $E19D00 (pour la 

premiere ligne) et s'etend jusqu'en $E19DC7 (ligne 200). La zone 

memoire de $E19DC8 k $E19DFF est reservee et devrait etre remplie 

de zeros. 

Les donnees concernant les points eux-memes commencent en 

$^12000, chaque ligne est representee par $A0 (160) bytes. 

L ' ^ choses se presentent done ainsi : 



Ligne 


SCB 


Points 


00 
01 
02 
03 

198 
199 


$E19D00 
$E19D01 
$E19D02 
$E19D03 

$E19DC6 
$E19DC7 


$E12000 
$E120A0 
$E12140 
$E121E0 

$E19BC0 
$E19C60 
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Les donn^es pour chaque point dependent de la resolution de la ligne 
: 320 ou 640 . En mode 320 points par ligne, chaque point peut prendre 
16 couleurs differentes, chaque point est done code par un nibble (un 
demi byte, 4 bits) representant une valeur entre et 15, cette valeur 
sert de pointeur pour la couleur dans la palette assign^ k la ligne. 



On y retrouve notre compte puisque : 

1. 2 valeurs ^ 4 bits = 16 couleurs possibles 

2. 160 bytes /ligne nous donne : 160 bytes * 2 points /byte = 320 
points /ligne 

En mode 320, les nibbles les plus significatifs codent pour les points 
pairs, les nibbles les moins significatifs pour les points impairs, 
exemple : $E12000: AB signifie que le point 00 de la premiere ligne est 
de couleur A, le point 01 de couleur B. Un byte code done pour 2 points 
en mode 320. 

Le mode 640 est un peu plus complexe, chaque point est code par 2 bits 
seulement (2^2 = 4 et 160 bytes * 8/2 = 640 points /ligne). La couleur 
representee par ces bits depend k la fois de leur valeur, et de leur 
position dans le byte : le pomt represente par les 2 bits les plus forts 
du byte (6-7) peut prendre les 4 premieres couleurs de la palette en 
vigueur (0-3), le point represente par les 2 bits suivants (4-5) peut 
prendre les 4 couleurs suivantes de la palette (4-7) etc... (voir la table 
suivante). Un byte code pour quatre points en mode 640. 



Bits 



Couleurs possibles 



6-7 


0-3 


4-5 


4-7 


2-3 


8-11 


0-1 


12-15 



Le mode 320 permet done d'afficher seize couleurs par ligne, sans 
alicuri conflit (comme c'etait le cas dans le mode HGR de 1 Apple II 
p.ex), h. chaque ligne peut etre assignee une palette particuli^re, 
jusqu'^ concurrence de seize palettes differentes pour une image 
donnee. Ceci pousse le nombre de couleurs maximum theorique h 256 
par image, tout en le limitant h seize par ligne. Nous verrons dans le 
chapitre «PROGRAMMATION SPECIALE» comment ameliorer cet 
etat de fait. 

copyright Too/box 1990 201 



Le mode 640 nous permet egalement seize couleurs par ligne, mais 
comme nous I'avons vu, chaque point particulier ne peut prendre que 
certaines couleurs precises, impossible d&s lors, d'obtenir des images 
640*200 en seize vraies couleurs. 
Toutefois certains programmes de dessin (et meme le FINDER) nous 

Eropose de choisir parmis seize couleurs en mode 640 ! 
a technique qu'ils utilisent s'appelle «DITHERING», elle consiste 
simplement k aligner deux points de deux couleurs differentes pour 
en simuler une troisi^me, ce syst^me reduit la resolution h 320 points 
par ligne (2 points 640 pour un point colore), mais il permet de 
Juxtaposer (p. ex) du texte en 640, deux couleurs, et des motifs colores. 
On remarque tr^s bien le DITHERING k I'ecran, I'image semble plus 
«granuleuse». 

Une autre technique utilisable est d'avoir des lignes en 320 et des 
lignes en 640 sur le meme ecran : les premieres permettant des dessins 
colores, les autres du texte en haute resolution noir & blanc. 



4.1.2 Palettes 

Les seize palettes definissables occupent la memoire de $E19E00 k 
$E19FFF, k raison de 32 ($20) bytes par palette, et de deux valeurs par 
couleur. Pour chacune des couleurs, on definit I'intensite de ses com- 
posantes verte, bleue et rouge. Chaque intensity peut prendre seize 
niveaux, elle est representee par un nibble, on a done la possibilite 
d'afficher 16*16*16 = 16^3 = 4096 couleurs differentes (RGB 12 bits, 4 
bits par composante). Deux bytes (un Word) sont alloues pour chaque 
couleur de cnaque palette, les intensites sont distributes de la faqon 
suivante : la composante verte occupe le nibble le plus fort du premier 
^yte, la composante bleue le nibble le plus faible de ce meme byte, 
enf in, la composante rouge occupe le nibole le plus faible du deuxilme 
byte, le nibble le plus fort du deuxi^me byte est en principe reserve et 
devrait etre laisse k z^ro. La couleur zero de chacune des palettes est 
definie par les deux premiers bytes de celle-ci, la couleur une par les 
deux suivants, exemple : la troisi^me couleur de la deuxidme palette 
est definie en $E19e4-$E19E47... 
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N° Palette 


Adresse 


00 
01 
02 
03 


$E19E00 
$E19E20 
$E19E40 
$E19E60 


OE 
OF 


$E19FC0 
$E19FE0 



L'adresse d'une couleur particuli^re d'une palette particuli^re est 
egale h : $E19E00 + $20 * le numero de la palette + 2 * le numero de la 
couleur. 

16 BITS DEFINISSANT UNE COULEUR 



VVVVBBBB OOOORRRR — 4 bits pour I'intensite du rouge 

! 
4 bits pour I'intensites du bleu 

4 bits pour I'intensite du vert 

Exemples de couleurs definissables : 

$00 00 - Noir 

$F0 00 - Vert 

$0F00 - Bleu 

$00 OF - Rouge 

$OFOF - Violet 

$FOOF - Jaune 

$FFOO - Bleu Clair 

$FFOF - Blanc 

$88 08 - Gris8 



4.1.3. Interruptions SCANLINE 

Le GS, contrairement k 1' Apple 11, autorise I'utilisateur k controler les 
interruptions software de type IRQ, des interruptions de ce type 
peuvent etre generees par le processeur video, appele VGC (Video 
Graphic Controller). Une interruption «SCANLINE» est generee en 
debut de raf raichissement d'une ligne donnee, si son SCB a le bit 6 mis 
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^ 1 . Ce type d' interruption est crucial pour les animations graphiques, 
nous en reparlerons en details, avec de nombreux exemples lorsque 
nous parlerons de programmation d'anin\ations diverses... Pour 
I'instant, la seule chose h retenir, est le fait que le bit 6 d'un SCB 
determine si I'interruption sera ^eneree ou non au niveau de la ligne 
correspondante (d'autres conditions sont bien sur necessaires !). 



4.1.4. MODE HLL (REMPLISSAGE) 

Ce mode semble etre I'exclusivite de I'Apple IIGS, je ne connais en 
effet pas d'autres machines possedant un syst^me meme rapproche. 
Ce mode permet de remplir instantanement de grande surface h 
I'ecran, il n'est accessible qu'en mode 320 points par ligne. Lorsqu'il 
est actif, la couleur 00 disparait, ne nous laissant plus qu'un choix de 
15 couleurs. Chaque point de couleur 00 aura, h I'ecran, la couleur du 
point aui le pr^c^e ! 
Ainsi, la sequence suivante : 

2000000 400000000 60000000000 70000 

apparaitra comme : 

??2?222 444444444 66666666666 77777 

La seule restriction est que le premier point d'une ligne en mode 
«FILL» doit avoir une couleur differente de 00, ou alors il apparaitra 
avec une couleur indeterminee (dependante des couleurs de la ligne 
precedente). 

Ce mode est actif pour une ligne, si le bit 5 de son SCB est ^ 1. II peut 
s'averer extremement utile pour les animations graphiques rapides 
d'objets, oil Ton peut se contenter de redessiner seulement les con- 
tours des objets, le remplissage se faisant par le hardware ... 



4.1.5 Memoire graphique (BANC $E1) 



$9FFF 



i ! <— 16 Palettes = $200 bytes 

! ! 

I I 



204 copyright Toolbo* 1990 



$9E00 

<— table des SCBs ($C8 bytes) 

$9D00 



< — Donnees des points ($7D00 bytes) 



$2000 



Total : $7D00 + $300 = $8000 bytes = 32k 

Cette memoire se trouve en banc $E1, un banc de memoire «lente» 
(appelee ainsi car k chaque acc^ k cette memoire, le processeur est 
ramene k sa vitesse d'origine : 1 MHZ, consulter le chapitre sur la 
memoire pour de plus amples renseignements). Pour accelerer les 
acc^s k la memoire, on peut utiliser le «SHADOWING». Decrit en 
details dans un autre chapitre, ce mecanisme nous permet, lorsqu'il 
est actif, de lire et d'ecrire les donnes graphiques en banc 01, celles-ci 
etant recopiees k I'^riture en banc $El . Cette technique ne resout pas 
tous les probl^mes de vitesse, car il ralentit egalement le processeur, 
mais lors de I'^criture uniquement (les valeurs doivent etre copiees 
hardwarement du banc 01 au banc $E1). Nous reparlerons abondam- 
ment du SHADOWING avec les techniques d'animation^our I'ins- 
tant, citons juste le Softswitch k modifier pour «SH ADOWER» la page 
SUPER-HIRES : il s'agit de $C035. 

Lorsque ce registre est k 00, toute valeur ecrite k une adresse du banc 
01 est automatiquement copiee k I'adresse correspondante dans le 
banc$El. 

Par exemple, la sequence suivante : 

LDA #$FF 
STAL $E19E1F 

est equivalent k : 

STZ $C035 
LDA #$FF 
STAL $019E1F 
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Pour visualiser cette memoire graphique, il faut manipuler un soft- 
switch, il s'agit de NEWVIDEO, k I'adresse $C029. 2 bits de ce 
Softswitch sont importants h connaitre : 

- Le bit 7 : s' il est mis a 1, permet I'affichage de la page Superes, s' il 
est h 0, permet I'affichage de tous les autres modes 

- Le bit 6 : doit ^tre mis ^ 1 si Ton desire lire ou ecrire dans la memoire 
graphique sans affichage. En effet, ce bit permet de lineariser la 
memoire graphique, si on oublie de le mettre h 1 avant d'ecrire, les 
valeurs ecrites risquent de ne pas se retrouver au bon endroit. 

Le bit 5 a egalement une fonction : 

- II determine si la page double haute resolution est en mode couleur 
ou en mode noir & blanc. Bit 5 : = double haute resolution couleur, 
1 = double haute resolution N&B. 



Les bits 0^4 sont reserves et ne doivent pas etre modifies. Lorsque le 
mode TEXT est selectionne, $C029 contient $21 . Consul ter le chapitre 
sur les softs witchs pour plus d' informations. 

En theorie, on devrait modifier ce switch avec ce type de sequences : 
- Affiche la Superes (bit 7 hi) 



LDA $C029 
ORA #$80 
STA $C029 



LDA $C029 
ORA #$40 
STA $C029 

LDA $C029 
AND #$3F 
STA $C029 



Linearise la Superes (bit 6^1) 



Passe en mode TEXT (bits 7, 6 et 5 mis ci 0) 



Mais en pratique, on utilise souvent des stockages directs : 

LDA #$A1 — Affiche la Superes 
STA $C029 

LDA #$41 — Linearise la memoire 
STA $C029 graphique 

LDA #$21 — Repasse en mode 
STA $C029 TEXT 
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Depuis le moniteur, on peut visualiser la page SUPER-HIRES en 
tapant : 

C029:A1 

CTRL-T <RETURN> remet le mode texte 

De meme, il est facile de recuperer une image d'ecran et de la sauver, 
sous PRODOS 8, sous moniteur taper : 

C029:41 : reste en TEXT, mais permet I'acc^s k la m^moire 
0/1000<El /2000.A000M : bouge la memoire graphique en banc 

BSAVE IMAGE,A$1000,L$8000 : Sauve I'image sur disque 

Pour reafficher I'image apr^ coup (sous PRODOS 8 et moniteur 
toujours) : 

BLOAD IMAGE : charge I'image en banc 00 

C029:41 : linearise la memoire avant de copier 

El/2000<0/1000.9000M : copie I'image 

C029:A1 : Affiche I'image 

Voir egalement dans les exemples de programmes qui suivent, les 
routines automatiques de copie et d'affichage. 

COPIE : Ce programme copie la memoire graphique en banc 00, d'oCt 
on peut la sauver. 

CLC 
XCE 

SEP #$30 
LDA #$4I 

STA $C029 ; linearise la memoire pour 

REP #$30 ; pouvoir la lire 

LDX #$7FFE ; X sert de compteur pour 

: 1 LDAL $E1 2000,X ; copier $7FFE bytes 
STAL $001000,X 
DEX 
DEX 
BPL :1 ; tant que X<>$FFFE 



SEP #$30 
RTS 
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Apr^s execution, on peut sauver I'image : 
BSAVE IMAGE,A$1000,L$8000 

Af fichage : copie une image (donn^es, SCBs et palettes) du banc 00 (ou 
elle a ete chargee) vers la m^moire graphique. 

CLC 

XCE 

SEP #$30 
LDA #$41 

STA $CG29 ; linearise la m^moire 

REP #$30 ; pour ecrire correctement 

LDX #$7FFE ; X sert de compteur pour 
:1 LDAL $001000,X ; copier $8000 bytes 
STAL $E12000,X 
DEX 
DEX 

BPL :1 ; tant que X<>$FFFE 

SEP #$30 
RTS 

Lorsque Ton travaille sur la page graphique, il est toujours agreable 
de pouvoir connaitre h tout instant I'adresse d'une ligne particuli^re. 
La formule en est simple : 

Adresse = $E12000 + n ligne * $A0 

Mais en pratique, il est assez compliqu^ de r^aliser des multijplica- 
tions et plutot long d'additionner des nombre en chaine. On preterera 
done creer une tables avec les adresses de toutes les lignes. Le pro- 
gramme suivant s'en occupe : 



CLC 
XCE 

REP #$30 

LDX #$0000 

LDA #$2000 

STA TABLE,X 

INX 

INX 

CLC 

ADC #$A0 

CMP #$9D00 

BNE:1 

SEP #$30 

RTS 



Mode 16 bits 

X = compteur de position 

Adresse de depart 

X = X + 2 



Adresse = Adresse + $A0 
(distance entre deux lignes) 
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II cree une table, h I'adresse TABLE, qui contient les adresses de toutes 
les lignes (codees en seize bits), sous la forme : byte faible, byte fort. 

Pour acc&der h une ligne quelconque, il suffit de faire : 
CLC 
XCE 

REP #$30 

LDA Ligne_Nb ; Numero de la ligne 
ASL ; Multiplie par deux 

TAX ;DansX 

LDA TABLE,X ; A contient alors 

; I'adresse du debut de 

; la ligne (seize bits) 



4.1.6 Registre monochrone / couleur 



Ce registre MONOCOLOR ($C021), option DISPLAY dans le CON- 
TROL PANEL, determine si la sortie composite du GS doit §tre en 
couleur ou en tons de gris. Le bit 7 (le bit le plus fort) est le seul k 
modifier : s' il est & 1, la sortie est monochrome, s' il est k 0, la sortie est 
couleur. 

Si vous avez un moniteur monochrome, choisissez 1' option mono- 
chrome, les images seront plus lisses, les couleurs etant representees 
par des degrades de gris plutot que par la juxtaposition c^ points. 



$C021 : REGISTRE «MONOCOLOR» 

bit 7 : = couleur 

1 = monochrome 

bits - 6 : reserves 



4.L7 Couleur en mode text 

Avec r Apple Ilgs, nous avons la possiblite de changer la couleur des 
caract^res en mode TEXT, la couleur du fond, ainsi que celle de la 
bordure d'ecran. La couleur pour chacune de ces zones peut §tre 
choisie parmis 16 couleurs disponibles (les couleurs sont les m§mes 
que celies de I'ancien mode GR, la basse resolution). On peut s^lec- 
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tionner ces couleurs soit depuis le CONTROL PANEL, soit directe- 

ment en modifiant les softswitchs adequats. Comme chaque couleur 

ne peut prendre que 16 valeurs, elle seront codees par un nibble (4 

bits). 

Deux softswitchs sont impliques dans ces reglages : TBCOLOR 

($C022) et CLOCKCTL ($C034). 





Bits 


Description 


$C022 


7-4 
3-0 


Couleur du texte 
Couleur du fond 


$C034 


7-4 
3-0 


Bits horloge/ ne pas modifier 
Couleur du bord 



Attention, ne pas toucher au bit 7 de $C034 lors du changement de la 
couleur du bord, utiliser des instructions du type : 

LDA $C034 
AND #$F0 
OKA #COULEUR 
STA $C034 

La table suivante donne les equivalents de chacune des couleurs en 
syst^me RGB. 



N° Couleur 


Couleur 


equivalent RGB 


00 


Noir 


00 00 


01 


Rouge 


03 OD 


02 


Bleu fonce 


09 00 


03 


Violet 


2D0D 


04 


Vert fonce 


72 00 


05 


Gris fonce 


55 05 


06 


Bleu moyen 


2F02 


07 


Bleu clair 


AF06 


08 


Brun 


50 08 


09 


Orange 
Gris clair 


60 OF 


OA 


AAOA 


OB 


Rose 


98 OF 


OC 


Vert clair 


DO 00 


OD 


Jaune 


FOOF 


OE 


Aquamarine 


F9 04 


OF 


Blanc 


FFOF 
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Le programme d'exemple qui suit montre comment harmoniser les 
couleurs de I'ecran SUPER HIRES avec celle du bord, en se servant de 
la table decrite prec^dement. 

ORG $900 

COULEUR = $00 



CLC 
XCE 

SEP #$30 

STZ COULEUR 

LDA #$41 

STA $C029 

REP #$30 

LDA #$0000 

LDX #$7FFE 

STAL $E12000,X 

DEX 

DEX 

BPL:1 



; Mem. graphique lineaire 
; Mode 16 bits 



; Efface tout : 

; donnees, table SCB 

; palettes 



SEP #$30 
LDA #$A1 
STA $C029 

LOOP LDA $C034 
AND #$F0 
ORA COULEUR 
STA $C034 
LDX COULEUR 
LDA COLTBl,X 
STAL $E19E00 
LDA COLTB2,X 
STAL $E19E01 
BIT $C010 

KBD LDA $C000 

BPL KBD 
LDA COULEUR 
INC 

AND #$0F 
STA COULEUR 
BRA LOOP 



; Retour en 8 bits 
; Affiche Super Hires 

; Couleur du bord 
; Epargne les bits 4h7 
; Modifie 
; Restocke 

; Tables de valeurs RGB 
; On modifie la valeur de 
; la couleur 00 de la 
; palette 00 

; attend une touche 



; incremente la couleur 
; qui ne peut pas 
; depasser #$0F 
; Continue 



COLTBl HEX 00,03,09,2D,72,55,2F,AF 
HEX 50,60,AA,98,D0,F0,F9,FF 
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COLTB2 HEX 00,0D,00,0D,0O,05,02,O6 
HEX 08,0F,0A,0F,00,0F,04,0F 
II est regrettable que Ton ne.puisse pas afficher des caract^res de 
couleurs differentes sur un meme ecran texte. Cet etat de fait est 
certainement dicte par la compatibilite avec les anciens modules de la 
serie II. II aurait en effet fallu, le cas echeant, modifier le mode text, 
ajouter de la memoire pour la couleur de chaque caract^re etc.. C'est 
dommage, car un mode ressemblant au mode ANSI d'IBM aurait pu 
nous ouvrir des portes (de plus en plus de serveurs am^ricams 
utilisent k fond le mode ANSI). 



4.1.8 NTSC / PAL 

Le syst^me TV americain diff^re du syst^me europeen de part sa 
frequence de rafraichissement d'image. Celle-ci est de 60 HZ aux 
Etats-Unis pour 50 HZ en Europe. 60 HZ (Hertz) signifie simplement 
que le processeur video rafraichit I'ecran 60 fois par seconde; gu'il 
envoie, 60 fois par seconde, les donn§es d'affichage de chaque ligne 
vers I'ecran. 

Un bit du registre LANGSEL ($C02B) (qui contient egalement les 
donnees relatives au langage du clavier), nous signale si le GS est en 
mode PAL ou NTSC. Ce bit est le bit 4. S' il est ^ 1 le syst^me est en PAL, 
s' il est h 0, le syst^me est en NTSC. Cette information se r^gle au 
RESET general (CTRL-OPTION-RESET) et est visible dans le CON- 
TROL PANEL, option DISPLAY. 

Les sequences k utiliser pour changer de mode sont les suivantes : 

LDA $C02B ; Passe en PAL 
ORA #$01 ; (met le bit 4 ^ 1 ) 

STA $C02B 

LDA $C02B ; Passe en NTSC 
AND #$EF ; (met le bit 4^0) 
STA $C02B 

En general, la plupart des moniteurs video acceptent des signaux 
dans les deux standards. Mais si vous utilisez une television munie 
d'une prise peritel, et que votre GS est en 50 HZ, vous pourriez avoir 
la desagreable surprise de voir votre televiseur perdre sa synchroni- 
sation lors d'un passage en 60 HZ; ce dernier ne reconnaissant pas le 
signal NTSC. 

Parlons maintenant des differences entre ces 2 modes. Nous avons dit 
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qu'en mode 60 HZ, I'ecran etait balaye plus souvent; pourtant le 
temps de balayage d'une ligne doit rester et reste touiours le meme. 
II en decoule qu'en 60 HZ, le processeur video est oblige de balayer 
moins de lignes, tout simplement ! 



Mode 



50 HZ 
60 HZ 



Lignes balayees 



312 
262 



Le rapport 50/60 est bien approximativement egal au rapport 262/ 
312. Ceci signifie que : 

1) Si un programme utilise le balayage en general pour sa temporisa- 
tion, il ira environ 1/6 plus vite sur un syst^me NTSC que sur un 
systfeme PAL. 



2) Si un programme utilise h fond le balayage pour se synchroniser et 

au'il accapare pratiquement tout le temps d'un balayage 50Hz, il se 
esynchronisera en 60Hz, car le temps d'un balayage est plus court 
d'un sixi^me environ ! 



Moralite : si on programme des animations synchronisees, mieux 
vaut le faire en 60 Hz, car elles marcheront toujours en 50Hz (temps 
de balayage plus long). 

Encore une derni^re remarque : le processeur video semble determi- 
ner k quelle frequence I'image sera balayee (50 ou 60HZ) au moment 
du VBL (instant ou le f aisceau electronique «remonte» du coin en bas 
h droite vers le coin en haut h gauche). II est done inutile d'essayer de 
changer de mode en milieu d'ecran, le changement ne s'effectuant 
qu'au balayage suivant. Si tel n'avait pas ete le cas, on aurait pu 
imaginer pouvoir afficher plus de 200 lignes en hauteur. En chan- 
geant de mode de mani^re synchronisee, on aurait peut-etre pu 
«repeter» I'affichage d'un certain nombre de lignes ! 



On peut encore se livrer h quelques petits calculs concernantles temps 
disponibles durant un balayage. Le 65C816 «tourne» au maximum h 
environ 2.8 MHZ, ce qui signifie qu'il execute 2"800"000 cycles/ 
seconde. En NTSC, I'ecran est balaye 60 fois par seconde, on peut en 
deduire que le nombre de cycles disponibles par balayage est de : 
2"800"000/60 = 46000 cvcles. Si on divise ce chiffre par 262 (nb de 
lignes rafraichies par balayage), on se retrouve avec 1/8 petits cycles 
disponibles par ligne d'ecran. C'est peu, surtout que ce chiffre est 
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encore trop elev6 par rapport k la r^alite : tout d'abord le 65C816 
toume toujours un peu plus lentement (il est ralenti par des acc^ 
DMA, des interruptions de service etc.). Ensuite, ce calcul presup- 

{>ose que le processeur reste k vitesse constante, ce qui est loin d'etre 
e cas, puisqu'^ chaque acc^s h de la m^moire lente (oanc $E0 et $E1), 
il repasse en mode I MHZ. 

Ces questions de temps seront r^xaminees avec les commentaires du 
programme «MULTICOULEURS». 



4.2. Animations graphiques, Programmation speciale 

A la lumi^re des constatations qui precedent, on se rend compte qu'il 
est plut6t difficile de programmer des animations rapides et de 
grande envergure sur GS. On peut neanmoins atteindre un niveau ac- 
ceptable, en utilisant des astuces de programmation. L'analyse qui 
suit, illustree de nombreux exemples de programmes, devoile quel- 
ques unes de ces astuces, utilisees dans la plupart des programmes de 
jeu vendus dans le commerce. 



4.2.1 Synchronisation 

Pour que les parties de I'^cran graphique en cours de mouvement 
semblent «glisser» harmonieusement, il est imperatif de les faire 
bouger lorsque le processeur video ne les balaient pas (lorsque le 
faiscaux ^lectronique rafraichit une autre partie de l'6cran) . Pour 
s' assurer de ce fait, il existe plusieurs moyens (j'en vols en fait 5) : 

(1) Utilisation du registre $C070 (marche sur Apple II+,IIe,IIc,II^s !) . 
Ce registre est un echo du byte actuellement lu par le processeur video 
(en mode Text et Simple High-Res en tout cas) . Done pour synchro- 
niser le 65C02 sur le haut de I'ecran High-Res, faire HGR, puis sous 
moniteur, remplir (p. ex) la zone $2000-$2020 avec des $Ad et ecrire 
le programme suivant : 

:1 LDA $C070 
CMP $#AB 
BNE:1 

En etant en mode HGR, il faut plusieurs « AB» car le processeur video 
est plus rapide que le 65C02 (je reviendrai ulterieurement sur ces 
prool^mes de vitesse et temps avec la description du registre HO- 
RIZCNT) 
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Cettemethode est limitee, par example si I'image af fichee contient des 
«AB», la synchro peut sauter de temps en temps. 
Ceci n'est pas une innovation de 1' Apple IIGS, mais ce Softswitch me 
paraissait mteressant k souligner, car son utilisation dans ce but n'a 
jamais ete decrite ik ma connaissance). C'est dommage, car c'etait 
certainement le seul moyen de synchronisation sur Apple 11+ et He. 
Seuls d'anciens programmeurs Californiens semblent le connaitre ! 



(2) Le registre $C019 (RDVBLBAR) (marche sur certains 2c et sur Ilgs) 
Ce registre est h $00 lorsque I'ecran (Text, graphique..) est balaye et k 
$80 lorsque le processeur video rafraichit les Dourdures haut ou bas 
(VBL). Done, pour synchroniser le processeur sur le debut de la 
bordure du bas, il sutfit d'ecrire : 

:1 LDA $C019 ; assure qu'on est 

BMI :1 ; sur I'ecran 

:2 LDA $C019 ; assure qu'on passe 

BPL :2 ; sur la bordure du bas 

Une programme de demonstration de cette technique pourrait etre : 

:1 LDA $C019 ; 65C02 synchronise sur le 

BPL :1 ; debut de la bordure du bas 

LDA #$0E ; Bordure de couleur $0E 
STA $C034 

:2 LDA $C019 ; Attend le debut de I'ecran 
BMI:2 

STZ $C034 ; Bordure noire 

BRA :1 ; On continue 

Ce aui nous donne des bordures haut et bas couleur «aquamarine» et 
des Dordures laterales noires ! 



(3) Le registre $C02E (HORIZCNT), gui est le reflet de la ligne en cours 
de rafraichissement. En fait, ce registre est incremente toutes les 2 
lignes seulement, il peut prendre les valeurs suivantes : 



Mode (HERZ) 



60 

50 



Valeurs de $C02E 



$7D k $FF 

$64 k $FF 



Ce registre permet une synchronisation verticale relativernent fine, il 
suffit pour cela d'attendre une valeur particuli^re k I'aidc d une 
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sequence LDA, CMP, BNE, exemple: 





CLC 






XCE 






SEP #$30 


mode 8 bits 


DEBUT 


LDX #$00 




:1 


LDA $C02E 


Position verticale 




CMP POS,X , 


attend une position 




BNE :1 


parti culi^re 




LDA $C034 






AND #$F0 






ORA COUL,X 






STA$C034 


Change la couleur du 




LDACOUL,X , 


bord et celle du fond 




STA $C0^? 


couleur des caract^res 




JNX 


= 00 




CPX #$04 


si X=4, on le ren\et ^ 00 




BNE:1 






BRA DEBUT 




POS 


HEX AO,BO,CO,E 


)0 ; Positions des changements de 
; couleur 


COUL 


HEX 02,0F,01,00 


; Couleurs : bleu, blanc, rouge 
; et noir pour finir 



Le registre $C02F (HORIZCNT) est un reflet de la position horizon- 
tale du faisceau electronique, cette valeur change tres rapidement, de 
sorte que le 65C816 n'est pas assez rapide pour se synchroniser ^ coup 
sur avec une sequence de type LDA CMP BNE. Ce registre peut 
neanmoins etre utilise ^ cette fin, si par exemple on teste une valeur 
sur plusieurs balayages de suite. II f aut alors garder precieusement la 
synchronisation acquise. Une autre technique consiste h. chercher 
plusieurs valeurs de positions horizontals possible, chacune condui- 
sant ^ une temporisation differente, aboutissant toutes h. la meme 
synchronisation. Cette discussion est purement pratique, Apple ne 
donnant d'ailleurs pas beaucoup d' informations sur ces registres. 
Enfin, vu leurs changements de valeurs tr^s rapides, ces registres sont 
souvents utilises comme g6n6rateurs de nomores al^atoires. 

Exemple : le programme suivant foumit des nombres relativement 
aleatoires entre $00 et $FF 
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TEMP = $00 



CLC 




XCE 




SEP #$30 




LDA $C02E 


; VERTCNT 


ASL 


; On extrait le nibble 


ASL 


; le plus faible 


ASL 




ASL 




EOR $C02F 


; HORIZCNT, change tr^s 


STA TEMP 


; rapidement 


LDA $C02E 




EOR TEMP 




EOR $C02F 





A contient un nombre aleatoire entre $00 et $FF 



(4) L'interruption Scanline. Cette interruption est I'une des deux que 
le VGC (Video Graphic Controller) puisse generer, 1' autre etant 1 in- 
terruption «une seconde». Lorsqu'une interruption software de type 
IRQ a lieu, le 65C816 interromptl' execution du programme en cours, 
sauve I'adresse k laquelle il se trouvait ainsi que le registre d'etat (P) 
dans la pile et saute dans un programme de la memoire morte (ROM) 
appele INTERRUPT MANAGER. L'INTERRUPT MANAGER com- 
mence par sauver les donnees minimums du moment (valeurs des 
registres...) puis il determine ensuite la source de l'interruption (gra- 
phique, sonore, en provenance de la souris...) et finalement le controle 
est donne h la routine d' interruption au travers d'un vecteur. Lorsque 
cette routine a termine son travail, le chemin se fait en sens inverse, le 
controle est redonne h I'ESfTERRUPT MANAGER, qui remet en place 
les donnees sauvegardees et termine par une instruction RTI (Return 
from Interruption) qui remet P et le Compteur de Programme h leur 
valeurs initiales, continuant ainsi 1' execution du programme inter- 
rompu comme si rien ne s'etait passe. 



La mise en oeuvre d'une interruption SCANLINE requiert les etapes 
suivantes : 

- Le mode graphique Super Hires doit etre actif 

- Au moins une ligne d'ecran doit avoir le bit d' interruption de son 
SCB^l 

- Le registre d'interruption VGC ($C023) doit avoir le bit d'autorisa- 
tion d'mterruption SCANLINE mis k 1 (bit 1) 
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- Le vecteur d'interruption SCANLINE doit pointer sur une routine 
de gestion d'interruption (JMPL en $E10028) 

- Cette routine doit signaler qu'elle s'est chargee de I'interruption en 
mettant le bit 6 du registre SCANINT ($C032) k 

- La routine d'interruption peut maintenant rendre le controle h 
L'INTERRUPT MANAGER, par I'intermediaire d'un CLC, RTL. 

Reprenons ces etapes en detail : 

1) Pour activer le mode SUPER-HIRES, il suffit de mettre #$A1 dans 
le registre NEWVIDEO ($C029) 

2) Le bit d'interruption dans un SCB est le bit 6, pour le mettre k un, 
il suffit d'ecrire : 

LDX #$10 ; X=N° de la ligne ou 

LDAL $E19D00,X ; I'on desire 

ORA #$40 ; I'interruption 
STAL $E19D00,X 

On peut egalement, k titre preventif, remettre les bits d'interruption 
des autres SCB k 0, pour etre star de n' avoir qu'une seule interruption 
par balayage d'ecran. On peut le faire comme ceci : 

LDX #$C8 
:1 LDAL $E19CFF,X 
AND #$BF 
STAL $E19CFF,X 
DEX 
BPL:1 

3) VGCINT : $C023 

Bit 1 - authorise I'interruption SCANLINE s' il est k 1 

Bit 2 - authorise I'interruption «Une Seconde» s' il est ^ 1 

Bit 5 - Statut de I'interruption SCANLINE, mis ^ 1 si I'interruption a 

eu lieu 
Bit 6 - Statut de I'interruption une seconde, mis ^ 1 si I'interruption a 

eu lieu 
Bit 7 - Statut d'interruption VGC, est mis ^ 1 si ^ la fois un bit 

d'autorisation et un bit de statut d'une meme interruption 
sont k 1 

Les bits 0,3 et 4 sont inutilises et ne doivent pas §tre modifies. 
En pratique, les bits 5,6 et 7 servent k detecter si une interruption VGC 
a eu lieu ou non (L'INTERRUPT MANAGER s'en sert pour determi- 
ner quel type d'interruption a ete declenchee). Ce qui nous interesse 



ais 
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pour le moment, c'est d'autoriser rinterruption SCANLINE, il suffit 
pour cela de forcer le bit 1 ^ 1 par I'instruction suivante : 

LDA $C023 
ORA#$02 
STA $C023 

4) Le vecteur d' interruption SCANLINE se trouve en $E10028 (avec 
les autres vecteurs d'interruption IRQ, interruption une seconde en 
$E10054 p.ex). Si on desassemble cette zone, on trouve : 

E10028: JMPL $FFB5DE (avec des ROMs 01) 

En $FFB5DE, on trouve simplement un SEC, RTL. 
Pour modifier ce vecteur, il taut changer I'adresse suivant le JMP (n 
de banc y compris). Par exemple, pour f aire pointer le vecteur en $320, 
banc 00, la sequence suivante fait tr^s bien 1' affaire : 

LDA #$20 
STAL $E10029 
LDA #$03 
STAL $E1002A 
LDA #$00 
STAL $E1002B 

5) Pour signaler que interruption k 6te prise en compte, le pro- 
gramme de gestion doit effacer un bit du registre SCANINT. 

SCANINT ($C032) 

Bit 5 - doit etre remis k z^ro pour que les interruptions SCANLINE 

continuent k avoir lieu. 
Bit 6 - doit etre remis k z^ro pour que les interruptions Une Seconde 

continuent k avoir lieu. 

La sequence adequate pour remettre SCANLINE k z6ro est done : 

LDA $C032 
AND #$DF 
STA $C032 

6) Le programme de gestion rend la main k I'lNTERRUPT MANA- 
GER k I'aide d'un : 

CLC 
RTL 
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Le CLC (mise h zero de la retenue) indique k I'INTERRUPT MANA- 
GER que rinterruption a ete correctement traitee, rinstruction RTL 
(Retour Long) est utilisee, car les vecteurs sont appel^s par des JSL 
(JSR longs). Le vecteur par defaut pointe en ROM, sur un SEC, RTL 
qui indique k I'INTERRUPT MANAGER qu'aucune routine de ges- 
tion n'est installee. 

Remarques : 

- il faut bien stir que le bit d'interruption du registre d'etat (P) soit k 
zero (interruptions authorisee) pour que cette sequence d'evene- 
n\ents puisse avoir lieu. Ceci est accompli par une seule instruction : 
CLI (CLear Interrupt bit) 

- L'interruption demandee pour une ligne a lieu au debut du rafrai- 
chissement de cette derni^re. C'est k dire une ligne plus haut, k 
I'interface entre I'ecran graphique proprement dit et la bordure 
droite. Malheureusement, I'INTERRUPT MANAGER prend 6nor- 
m^ment de temps pour determiner la source de l'interruption, sauver 
les registres.. .etc si oien que lorsque la routine d'interruption prend le 
controle, plusieurs lignes auront dej^ ete balayees (environ S). Cette 
perte de temps peut etre reduite si I'on prend directement le controle 
de l'interruption en sautant I'INTERRUPT MANAGER. II suffitpour 
cela de modifier le vecteur en $E10010 (INTERRUPT MANAGER de 
la memoire morte). D^s cet instant, il faut ^erer soi-meme toutes les 
interruptions IRQ (video, son, clavier, souns, interface serie...) ce qui 
est loin d'etre facile ! En pratique, il est fortement deconseille de 
toucher k ce vecteur, k moins peut-etre, d' avoir une tache tr^s precise 
et rapide k accomplir. 

Le programme qui suit est un exemple d'utilisation de I'interrupt 
SCANLINE. II dessine un point blanc qui rebondit entre les bords 

fauche et droit de I'ecran le point bouge de deux positions k chaque 
alayage. Le programme est enti^rement autonome et lorsqu'il est 
lance, on se retrouve sous moniteur (avec la page SUPER-HIRES 
affichee). CTRL-T permet de revenir au mode text, en arretant l'inter- 
ruption puisque la SUPER-HIRES est alors inactivee. Tout peut etre 
reactive en tapant : C029: Al (retour en SUPER-HIRES). On peut aussi 
lancer un programme basic en parall^le, ce dernier etant interrompu 
50 ou 60 fois par seconde ! Les possibilites sont innombrables. 
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Le programme BASIC, lance «POINT» en interruption, puis extrait 
les racines carrees des nombres de 1 ^ 256 en incrementant la couleur 
de la bordure (adresse $C034 = 49204). Lorsque ceci est termine le 
mode text est force (49193 = $C029). 

Une demonstration d'un mode pseudo multitache, ou 2 programmes 
semblent s'executer en meme temps. 

10 PRINT CHR$(4);»BRUN POINT» 

20 FOR N=l TO 256 

30 PRINT N,SQR (N) 

40 POKE 49204,PEEK(49204)+1 

50 NEXT 

60 POKE 4919333 



PROGRAMME «POINT» 





ORG $A00 




OLDPOS 


= $00 




NEWPOS 


$01 




DIREC 


$02 

CLC 
XCE 

SEP #$30 
LDA #$A1 
STA $C029 






STZ OLDPOS 


; Ancienne position k 00 




STZ NEWPOS 


; Nouvelle position k 00 




LDA #$01 


; Direction vers la droite 




STA DIREC 


;(+!) 




REP #$30 






LDA #$0000 


; Efface I'ecran graphique 




LDX #$7FFE 




CLR 


STAL $E12000,X 

DEX 

DEX 

BPL CLR 






LDA #$0FFF 


; Couleur OF de la palette 




STAL $E19E1E 


; 00 mise en blanc 
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SEP #$30 
LDX #$C8 
CLILOP LDAL $E19D00-1,X 
AND #$BF 
STAL$E19D00-1,X 
DEX 

BNE CLILOP 
SEI 

LDAL $E19D66 
ORA#$40 
STAL $E19D66 
LDA #$5C 
STAL $E10028 
LDA #$00 
STAL $E1002B 
LDA #INTER 
STAL $E10029 
LDA #>INTER 
STAL $E1002A 
LDA $C023 
ORA#$02 
STA $C023 
CLI 
SEC 
XCE 
RTS 



; Mise k zero des bits 
; d'interniption de 
; tous les yCB 



; Interruption k la ligne $66 



; Assure la presence d'un 

; JMPL au aebut du vecteur 

; Banc de la routine 

; d'interruption 

; Adresse partie basse 

; Adresse partie haute 

; Mise k un du bit 1 

; du registre VGCINT 

; autorise SCANLINE 

; assure le bit INT du registre 

; d'etat k zero 

; SEC XCE necessaire avant le 

; retour au BASIC 



INTER 



LDA $C032 
AND #$DF 
STA $C032 

PHB 

LDA #$E1 
PHA 
PLB 



; Mise k zero du bit 5 
; de SCANINT, pour que 
; SCANLINE continue 

; Sauvegarde du banc de donnee 
; Banc mis ^ $E1 



LDX OLDPOS 
LDA #$00 
STA $5DE0,X 
STA $5E80,X 
STA $5E81,X 
STA $5F20,X 

LDX NEWPOS 
LDA #$0F 



; Efface le point k 
; I'ancienne position 

; Adresses des lignes 
; ou 6volue le motif 
; du point 

; Dessine le nouveau 
; point 
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STA $5DE0,X 

STA $5F20,X 

LDA#$FF ; Byte de motif 

STA$5E80,X ;Adressedelalime 

LDA #$F0 ^ 

STA $5E81,X 

PLB ; R^cupdre le banc 

LDA NEWPOS ; Pourl'effacement ult^rieur 

STA OLDPOS 

CLC 

ADC DIREC ; Direction (+1 ou -1) 
TAX 

BEQ CHNG ; Changement si POS = 00 

CMP #$9E ; ou si POS = $9E 
BNEOK 

CHNG LDA DIREC ; Changement de direction 

EOR#$FE ;+lou-l($FF) 
STA DIREC 

OK STX NEWPOS 

CLC ; Tout s'est bien pass^ 

RTL ; Retour k I'INTERRUPT MANAGER 

(5) L'interruption VBL. Cette interruption est g^neree 50 ou 60 f ois par 
seconde en ?m de balavage de I'ecran. File se contrdle pratiquemSnt 
comme 1 interruption SCANLINE, une des seules diffeen?es nota- 
bles est le fait qu elle est active quel que soit le mode vid^ s^lectionn^. 
Voia les vecteurs et switchs impliqu^s : 

Le vecteur se trouve en $E10030 

LeswitchautorisantleVBLetINTEN($C041),voidlasignificationde 

Bits 0,1,2 - Autorisent le contrdle de la souris par le chip MEGA II 
Bit 3 - Si mis k un, autorise les interruptions VBL 
Bit 4 - Si mis k un, autorise les interruptions «quart de seconde» 
Bits 5,6 et 7 - R^serv^s, mis k z^ro 
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Apr^s le traitement de 1' interruption, il faut remettre le switch 

CLRVBLINT ($C047) k zero pour que 1' interruption ait lieu k nou- 

veau. 

Le switch INTFLAG ($C046) nous renseigne si une interruption VBL 

a eu Ueu ou non. Ses bits les plus importants sont : 

Bit 7- est h. un si le bouton de la souris est enfonc^ 

Bit 6 - est ^ un si le bouton de la souris 6tait enf onc6 k la derni^re lecture 

Bit 4 - est ^ un si une interruption quart de seconde a eu lieu 

Bit 3 - est k un si une interruption VBL a eu lieu 

Bit 2 - est ^ un si le switch souris du chip MEGA II a genere une 

interruption 

Bit 1 - est ^ un si un mouvement de la souris au travers du chip MEGA 

II k gen6r6 une interruption 

Void un petit programme de demonstration de 1' utilisation de 1' inter- 
ruption VBL, qui utilise cette interruption pour changer la couleur de 
la Dordure k chaque balayage. 



INTER 



ORG $900 




CLC 




XCE 




SEP #$30 




SEI 




LDA #$5C 


; Assure un JMPL 


STAL $E10030 




LDA #$00 


; Vecteur, banc 


STAL $E10033 




LDA #INTER 


; Vecteur partie basse 


STAL $E10031 




LDA #>INTER 


; Vecteur partie haute 


SIAL $E10032 




LDA $C041 


; Interruption VBL 


ORA#$08 


; authonsee 


STA $C041 




CLI 




RTS 


; Revient au moniteur 




; ou au BASIC 


STZ $C047 


; R^g^n^re 1' interruption VBL 
; Incr^mente la couleur de 


INC$C034 




; la bordure 
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CLC ; Retour k I'INTERRUPT 

RTL ; MANAGER 

Note : L'interruption VBL n'est pas tellement utilise dans un but de 
synchronisation vid^, elle agit plutot comme compteur de temps, 
comptant les SO^mes ou 60dmes de seconde ! 
Elle est utilisee pour la gestion du pointeur de la souris et rythme le 
«HeartBeat» du GS (une fonction au syst^me qui permet de chainer 
des taches ex^cut^s tous les VBL). 

Tous ces modes de synchronisation se ressemblent( du moins deux k 
deux: interruptions VBL avec $C019-RDVBLBAR et interruptions 
SCANLINE avec $C02E-VERTCNT). II faut choisir lecjuel utiliser 
d'apr^s les besoins de son programme. Si une tache doit imp^rative- 
ment etre ex4cut^ tous les balayages, mieux vaut utiliser une inter- 
ruption, cette demi^re 6tant ex^cut^ m^me si le programme princi- 
paie calcule pendant plus d'un balayage. 

Encore deux derni^res remarques k propos des interruptions en 
general sur GS : 

- Dans les exemples de programmes ci-dessus, les vecteurs sont 
modifies en stockant les nouvelles valeurs directement en banc $E1, 
ce qui n'est pas une pratique de programmation tr^s "propre". Apple 
nous met en garde, ces vecteurs pourraient §tre d^places dans des 
versions futures du GS. Nous devrions utiliser les outils «GetVector» 
(n 1 1 03) et «Set Vector » (n 1 003) pour respectivement lire et ^crire les 
valeurs des vecteurs d' interruption. Chacun fait ce qu'il veut. 

- n n'y a pas, sur GS, de niveau d'interruption. Ou, autrement dit, 
toutes les interruptions ont le meme niveau d'importance. Ce qui 
signifie que si une interruption est en cours de traitement, toute 
interruption g4n4r4e, quelle qu'elle soit, sera mis en ligne d'attente. 
Ceci peut s'av^rer tr^ g^nant si Ton g^re des interruptions en prove- 
nance de plusieurs sources. Admettons qu'une interruption SCAN- 
LDSfE ait lieu alors qu'une interruption sonore est en cours de traite- 
ment, l'interruption vid^ sera retard^ de quelques lignes rendant 

Eeut-etre I'effet recherche caduc ! (voir programme «MULTICOU- 
EUR» k la fin du chapitre. La solution k ce probl^me consiste peut- 
etre k n'utiliser qu'un seul type d'interruption k la fois, remplagant le 
travail de I'autre par des switchs. Dans notre cas, il suffirait de laisser 
interruption sonore active, d'avancer un p)eu l'interruption graphi- 
que (de quelques lignes), puis, une fois cette derni^re g^n^ree, de se 
synchroniser parfaitement k I'aide du switch VERTCNT ($C02E). La 
recriture d'un nouvel INTERRUPT MANAGER pourrait r^soudre ce 
probldme, mais k un prix cher paye. 
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4.2.2 SCROLLINGS toutazimut 



Avant la presentation d'un exemple, void quelques faits relatifs aux 
mouvement d' images en general : 

- Si le mouvement est de plus d'un point entre deux positions alors il 
faut imp^rativement tout recopier k chaque balayage. Si le temps 
manque, passer en mode un point entre 2 positions et observer. If y 
aura de toute fagon des scintillements, mais le r^sultat peut s'av^rer 
acceptable. 

- Pour bouger de grandes zones m^moire, on est oblige de recourir k 
des boucles en assembleur. Avec 1' arrive du 65C816, on serait tent^ 
d'utiliser les instructions MVP et MVN, qui permettent de copier des 
blocs de m^moire d'un seul coup. Ces instructions sont int^ressantes, 
car permettant la recopie d'un banc de m^moire vers un autre, mais 
elles sont relativement lentes : il leur faut 7 cycles pour copier un seul 
byte ! On peut faire nettement plus rapide en utilisant une autre 
particularite du 65C816 : la possibility de ce dernier d' avoir une page 
zero et une pile mobiles dans des limites de 64K. II est d^s lors tres 
facile de positionner la page z^ro en d^but d'une li^ne graphi(jue, par 
exemple, et de copier des valeurs sur I'image en utilisant des mstruc- 
tions page zero, moins gourmandes en cycles. 



Instruction 


nb cycles 


page z^ro 


LDA 
STA 
LDA,X 
STA,X 


(AD) 4 
(8D)4 
(BD) 4+ 
(9D) 5+ 


(A5) 3 
(85) 3 
(B5) 3 
(95) 4 



Le + Signifie qu'il faut rajouter un cycle en cas de saut de page, c'est 
k dire si I'adresse + X depasse la limite de la page en cours ($1000, 
$1100..., voir chapitre sur le microprocesseur). Encore une chose k 
savoir : lorsque le 65C816 est en mode 16 bits, toutes les instructions 
ayant un rapport avec les registres sont major^s d'un cycle. Cette 
meme majoration a lieu lorsque la page z^ro est plac^ k une adresse 
dont le byte le plus faible n'est pas egal k z^ro. Les scrolls les plus 
rapides seront done ceux ou Ton bouge I'image ^uatre points par 
quatre (16 bits par 16 bits) et dont la page z^ro est fix^ k une adresse 
multiple de $100. Le temps d'ex^cution d'un couple LDA page z^ro, 
STA page z^ro devient alors : (3 + l) + (4 4-l) = 9 cycles, ce qui nous 
ram^ne k 4.5 cycles par byte, soit 9/14 seulement au temps pris par 
une instruction MVN. 
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Les instructions permettant de changer les valeurs du registre D 
(position de la page z^ro) sont les suivantes : 

TCD - Transfert de C (A 16 bits) dans D 

TEXZ - Transfert de D dans I'accumulateur 16 bits 

PHD - Empile le registi-e D (16 bits) 

PLD - D^pile le registi-e D 

Pour permettre k la page z^ro et k la pile de se trouver en banc 01 (la 
page graphique en puissance si le shadowing est fonctionnel), il faut 
toucher au registre STATREG ($C068). Plus precis^ment, il faut forcer 
les bits 4 et 5 de ce switch k 1 . Ces deux bits permettent respectivement 
r^criture et la lecture de la page z^ro et de la pile en banc 01. II faut, 
en plus, que les routines effectuant ces operations ne soient pas en 
banc 00 ! . EUe peuvent §tie dans n'importe quel autre banc, bien que 
le banc 01 semole etre le plus logique. 

Sequence fixant le d^but de la page z^ro en $2000, (banc 01, p.ex) 

CLC 
XCE 

REP #$30 
LDA $C068 
ORA#$30 
STA$C068 
LDA #$2000 
TCD 



Cette routine doit imp^rativement se trouver en banc 01. 

L'exen\ple qui suit utilise des pseudo codes operatoires de MERLIN 
16, qui permettent de g^n^rer une s^rie d'instructions. La s^uence 
suivante : 

LDA $02 
STA$00 
LDA $04 
STA$02 
LDA $06 
STA$04 
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Est le fruit de 1' assemblage de ce code source : 

]POS = $00 ; La variable d'assemblage 

; ]POS est mise k z^ro 

LUP $7F ; Boucle r^p^t^ $7F fois 

LDA ]PC)S+2 ; Assemble I'instruction LDA 

; p. z^ro avec I'adresse POS 
STA ]POS ; idem pour STA avec POS+2 

IPOS = lPOS+2 ; POS et ii\cr^ment6 de 2 

; avant la creation de 
; I'instruction suivante 

— ^ ; Signifie que Ton complete 

; la boucle 



Scrolling Horizontal, de droite k gauche. 4 points par balayage, 32 
lignes de hauteur. Le principe en est le suivant : 

1 - Sauver les points de I'extreme gauche 

2 - Bouger I'image vers la gauche de 4 points 

3 - copier les points sauv^s a I'extreme droite 

Ce programme utilise HORIZCNT ($C02E) pour se synchroniser. Le 
lancer avec une image quelconque d^]k en m^moire. 



ORG $900 



CLC 
XCE 

SEP #$30 

LDA #$A1 

STA $C029 

STZ $C035 ; Shadowing actif 

BIT $C010 

REP #$30 

LDX #AUX ; Va copier la routine AUX 

LDY #$1800 ; en banc 01 : adresse $01 1800 

LDA #AUXEND-AUX 
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MVN $000000^10000 



PHK 
PLB 



; Restore B, perturb^ 
; par le MVN 



LDX #$7FFE ; Copie de I'image du 
COPY LDAL $E12000,X ; banc $E1 en banc 01 
STAL $012000,X ; pour pouvoir 
DEX ; travailler en banc 01 avec 

DEX ; le shadowing on 

BPL COPY 



SYNC 



QUIT 



SEP #$30 
LDA $C02E 
CMP #$D8 
BNE SYNC 

REP #$30 

JSL $011800 

SEP #$30 

LDA $C000 
BMI QUIT 
JMP SYNC 

LDA #$21 
STA $C029 
RTS 



Attend une position du 
balayage 

; Mode 16 bits 

Appel de la routine AUX 

Mode 8 bits 
; Teste le clavier 



; Sortie, on affiche le 
; mode text 
; et on sort 



AUX 



]FROM 
]TO 



MX 00 



LDA$C068 
ORA#$30 
STA$C068 
PHD 

FHD 

PHK 

PLB 

LDA #$A000 

TCD 

= $8900 

= $00 



; Obligatoire, car la suite doit §tre assem 
; bl^ en 16 bits 

; Page Z6ro et Pile en banc 01 



; Cree la sequence qui 
; copie la bande de gauche 
; dans le buffer ($A000) 
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]FROM 
]TO 



LUP$20 
LDA ]FROM 
STA ]TO 
= ]FROM+$A0 
= ]TO+$2 



$20 instructions g^n^rees 
dutype LDA $8900 
STA $A000 



LDX #$02 
LDA #$8900 
LOOP TCD 

]POS = $00 

LUP$7F 

LDA ]F0§+2 

STA ]POS 
]POS = ]POS+2 



Scroll vers la gauche 
en lui-meme 
D commence k $8900 
(un multiple de $100) 



LDA ]POS,X 
STA ]POS 

TDC 
CLC 

ADC #$100 
CMP #$9D00 
BEQ END 

BRL LOOP 



Obligatoire au saut 
de page : 

LDA$FE,X(=$100) 
STA $FE 



END 

]TO 
]FROM 



]FROM 
]TO 



LDA #$A000 
TCD 
= $899E 
= $00 

LUP$20 
LDA ]FROM 
STA ]TO 
= ]FROM+$2 
= ]TO+$A0 



; Recopie du Buffer 
; vers ta droite de 
; la bande du scroll 
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LDA $C068 
AND#$CF 
STA $C068 



PLB 
PLD 

AUXEND RTL 



; Remet $C068 k sa 

; valeur de depart 

; (PZ et Pile en banc 00) 

; Recup^re B et D 

; Retour en banc 00 



Cette technique est utile, mais tr^s limit^.La zone couverte par des 
instructions page z^ro n'a pas plus de $100 bytes de long, les scrolls 
verticaux sont done perilleux voir impossibles. On peut am^liorer 
cette technique en utilisant, en plus, la pile. L'exemple suivant est un 
scroll vers le haut d'une fenetre de 200 par 65 points. L'instruction au 
coeur de ce programme est PEL Cette instruction, sp^cifique au 
65C816, signifie que Ton empile le contenu d'une case m^moire en 
page zero. L'instruction : 

PEI $30 

est equivalente k la sequence : 

LDA $30 
PHA 

Mais ne prend aue 6 cycles ! L'astuce de ce scroll est de positionner la 
page zero au d^but de la ligne de depart, le pointeur de pile en fin de 
ligne d'arriv^e (k chaque empilement, le pointeur de pile est d^cr^ 
mente), et d'ex^cuter une sequence de PEI. Les pseudo codes op6ra- 
toires (LUP, — ^...) de l'exemple precedent sont k nouveau presents. 



ORG $900 

CLC 
XCE 

SEP #$30 

LDA #$A1 
STA $C029 
STZ $C035 
BIT $C010 



; Affiche Super hires 
; Shadowing actif 



REP #$30 
LDX #AUX 
LDY #$1800 



; Copie la routine scroll 
; en RAM auxilliaire 
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LDA #AUXEND-AUX 
MVN $000000^10000 



PHK 
PLB 




LDX #$'/^FE 
COPY LDAL$E12000,X 
STAL $012000,X 
DEX 
DEX 
BPL COPY 


; Recopie I'image du 
; banc El en banc 01 


CONT SEP #$30 
SYNC LDA $CO?F 
CMP #$92 
BNE SYNC 


; Attends une valeur du 
; balayage 


REP #$30 
LDX #$0062 
:1 LDAL $01341E,X 
STA$9000,X 
DEX 
DEX 
BPL:1 


; Sauve la ligne la plus 
; haute de la f enetre 
; dans une z6ne 
; tampon : $9000 


JSL $011800 

LDA #$0000 
TCD 


; Bouge toutes les lignes 
; d'un cran vers le haut 
; Remet la page z^ro au bon 
; endroit 


SEP #$30 




LDA $C000 
BMI END 


; Si une touche est press^ 
; on arr§te tout 


REP #$30 




LDX #$0062 
:2 LDA $9000,X 

STAL$015C1E,X 

DEX 

DEX 

BPL:2 

BRA CONT 


; Recopie la ligne sauv6e 
; tout en bas de la 
; fendtre 



END LDA #$21 
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; Fin, on repasse en mode 



L 



STA $C029 
RTS 



AUX TSX 

LDA$C068 
ORA #$0030 
STA $C068 

LDA #$3481 
TCS 

LDA #$34BE 
LOOP TCD 

]POS = $62 

LUP$32 
PEI ]POS 

]POS = jPOS-2 

A 

'^' TSC 
CLC 

ADC #$104 
TCS 
TDC 

ADC #$A0 
CMP #$5D00 
BCC LOOP 

LDA $C068 
AND #$00CF 
STA$C068 
TXS 
AUXEND RTL 



; text 

; Routine SCROLL, en RAM auxilliare 
; Sauve le pointeur de pile 
; P. Z6ro et pile en banc 01 



Fin de la li^e destination 
Dans le pointeur de pile 
Debut de la ligne source 
= Debut de la page zero 



; Cree les instructions PEI 

PEI $62 
PEI $60 
PEI $5E .... 
Fin d'une ligne 

; Ligne destination suivante 



; ligne source suivante 

; Termine ? 

; Remet la page z6ro et la 
; pile en banc 00 

; R^cup^re le pointeur de pile 
; revient en banc 00 



L'astuce du changement d'adresse de la pile peut ^galement etre 
utilisee pour changer des valeurs en banc 01 tr^s rapidement. Les 
couleurs d'une palette peuvent §tre changes par une Doucle du type: 

LDX #$1F 
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COPY LDA TABLE,X 
STAL $E19E00,X 
DEX 
BPLCOPY 

Cette boucle est lente, et si le temps est compt^ (en cas de changement 
de palette k chaque ligne), on lui pr^f^rera la routine suivante : 

LDA$C068 

ORA#$30 

STA $C068 

LDA #$9E20 

TCS 

PEA $OFFF 

PEA $FOFO 



Le pointeur de pile est plac^ au sommet de la palette 00 ($9E00-9E1F), 

PUIS les valeurs des couleurs sont empil^s, a I'aide de instruction 
EA (Push Effective absolute Adress, consulter le chapitre sur le 
microprocesseur pour plus d'informations). Auparavant, on aura pris 
soin ae positionner la pile et la page z^ro en banc 01, tout en se 
rappelant que cette routine doit se trouver dans un banc autre que le 
banc 00 ! 

Ces techniques de scroll, malgr^ leur ing^niosit^, sont limit^s par la 
lenteur du processeur. Arriver k bouger une fendtre entre trente et 
quarante lignes par balayage sen\ble etre le maximum envisageable 
pour un scroll horizontal. La fenetre de I'exemple 2, de dimension 65 
* 200 points est certainement la plus grande animable h chaque 
balayage. 

4.3 SPRITES 

Apr^s les mouvements de portions d'^cran, abordons les mouve- 
ments d'objets individuels sur I'ecran. L' Apple Ilgs ne poss^de pas, 
comme certaines machines, de «sprites» hardware. II va done fafloir 
que nous les gerions nous-m^me. Des routines ROM existent pour 
cela,elles sont non sp^fiques et un peu trop lentes pour nous permet- 
tre d'atteindre de Dons r^sultats. Lorsque Ton bouge un objet en 
premier plan devant un decor, il faut non seulement sauver ce dernier 
pour le redessiner apr^ coup, mais il faut ^galement respecter les 
zones transparentes de I'objet. 

Pour cela, nous utiliseront des techniques classiques d'animation. II 
faut tout d'abord cr^r un «masque». Le masque est une sorte de 
n^gatif de I'objet k bouger. A chaque point de couleur de I'objet, on 
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fait correspondre un $F dans le masque. A chaque point de I'objet de 
couleur autre que 0, correspond un dans le masque. Exemple : 

Une ligne de points : OA AA AO 00 12 21 00 30 04 
MASQUE : FO 00 OF FF 00 00 FF OF FO 

Le role du masque est de mettre k les points du d^cor correspon- 
dants k des points de couleur de I'objet. Lorsque Ton effectue le ET 
logique (AND) entre le d^or et le masque, une silhouette noir 
representant les points non transparents de I'objet apparait. H suffit 
ensuite, de realiser un OU (ORA) entre cette silhouette et les donn^es 
de I'objet lui-meme pour que ce dernier se dessine. 

Toutes ces operations pourraient etre realisees sur des zones de 
memoire tampon, par des routines du type : 

:1 LDA $2000,X 

AND $1000,X 
ORA$1100,X 
STA $2000,X 
DEX 
^ BNE :1 



Ces routines sont trop lentes, pour atteindre une vitesse optimale, il 
est imperatif de : 

1) Travailler en 16 bits. 

2) Realiser les operations d^crites pr4c4demment en mode imm^iat, 
c'est k dire : charger les points du d^cor, les sauver, effectuer le AND 
avec le masque, le ORA avec le motif et finalement stocker les points 
ainsi traites. 

3) Programmer tout ceci avec une suite d'instructions, sans boucles ! 



Le programme suivant affiche une petite croix en haut k gauche de 
I'ecran. Cette croix peut etre d^plac^ k I'aide des quatre filches du 
claviers dans les quatre directions. Le d^placement effectud est de une 
case vers le haut et le bas et de deux cases (un byte) vers la gauche et 
la droite. II est preferable qu'une image se trou ve d^j^ en memoire lors 
de son lancement. La croix est de couleur $0F. 
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PROGRAMME «SPRITE» 



ORG $900 




NEWPOS = $00 




OLDPOS = $02 




CLC 




XCE 




SEP #$30 




LDA #$A1 


; Super hires affich^ 


STA $C029 




STZ $C035 


; Shadowing actif 

; Le banc «aonnees» est le 


LDA #$01 


PHA 


; banc 01, STA $1000 signifie 


PLB 


; maintenant STAL $011000 



COPY 



LOOP 



KBD 



REP #$30 

STZ NEWPOS ; Position du sprite de 00 h. $7A7C 

LDX #$7FFE 

; Copie la m^moire 
; graphique du banc 
; $E1 en banc $01 



LDAL $E12000,X 

STAL $012000,X 

DEX 

DEX 

BPL COPY 



JSR DRAW 

SEP #$30 
JSR WAIT 
REP #$30 
jSR ERASE 
JSR DRAW 
SEP #$30 
LDA $C000 
BPL KBD 
BIT $C010 
CMP #$95 
BEQ RIGHT 
CMP #$88 
BEQ LEFT 
CMP #$8B 
BEQ UP 
CMP #$8A 
BNE KBD 



; Dessine la croix une premiere fois, pour 
; sauver le d^cor 

; Attend le balayage 

; Efface la croix 

; la redessine k sa nouvelle 

; position 

; Lit le clavier 



Fl^che k droite 
Fl^che k gauche 
Fl^he en haut 
Flfeche en bas 
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DOWN 



UP 



RIGHT 



LEFT 



REP #$30 

LDA NEWPOS 

CLC 

ADC #$A0 

BRA CONT 

REP #$30 

LDA NEWPOS 

SEC 

SBC #$A0 

BRA CONT 

REP #$30 

LDA NEWPOS 

INC 

BRA CONT 

REP #$30 

LDA NEWPOS 

DEC 

BRA CONT 



; Change la position 
; de la croix d'apr^s 
; la touche press^ 



CONT 
OKI 

OK2 



WAIT 
W2 



DRAW 



BPL OKI 
LDA #$0000 
CMP #$7A7C 
BCC OK2 
LDA #$7A7C 
STA NEWPOS 
BRA LOOP 

MX 11 

LDA $C019 
BMI WAIT 
LDA $C019 
BPLW2 
RTS 

MX 00 

LDX NEWPOS 
LDA $2000,X 
STA $A000 
LDA #$FFFF 
STA $2000,X 
LDA $2002,X 
STA $A002 
AND #$0F00 
ORA #$FOFF 



; V^rifie le non-d^passement 
; des limites de I'^cran 



; Continue 

; N^cessaire, car la suite est en 8 bits 

; Attend le bas de 
; r^ran graphique 

; Et revient 

; Suite en 16 bits 

; X = position de la croix 



; Chargement du d4cor 
; Sauvegarde dans le buffer 
; ET avec le masque 
; OU avec les donn^es 
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STA $2002,X 
LDA $20A0,X 
STA $A004 
AND #$FFOF 
ORA #$O0F0 
STA $20A0,X 
LDA $20A2,X 
STA $A006 
AND#$OFFF 
ORA #$F000 
STA $20A2,X 
LDA $2140,X 
STA $A008 
AND #$FOOF 
ORA #$OFFO 
STA $2140,X 
LDA $2142,X 
STA $AOOA 
AND #$OFFF 
ORA #$F000 
STA $2142,X 
LDA $21E0,X 
STA $AOOC 
AND #$FFOF 
ORA #$00F0 
STA $21E0,X 
LDA $21E2,X 
STA $AOOE 
AND#$OFFF 
ORA #$F000 
STA $21E2,X 
LDA $2280,X 
STA $A010 
LDA #$FFFF 
STA $2280,X 
LDA $2282,X 
STA $A012 
AND #$0F00 
ORA #$FOFF 
STA $2282,X 
LDA NEWPOS 
STA OLDPOS 
RTS 



; Stockage sur le d^cor 
; Et on continue pour 
; chaque s^rie de points 



ERASE 



LDX OLDPOS 
LDA $A000 
STA $2000,X 



; Ancienne position 
; Recopie les donnas 
; du Buffer (Tampon) 
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LDA $A002 ; sur le decor 

STA $2002,X ; Operation inverse de la 

LDA $A004 ; sauvegarde 

STA $20A0,X 

LDA $A006 

STA $20A2,X 

LDA $A008 

STA $2140,X 

LDA $AOOA 

STA $2142,X 

LDA $AOOC 

STA $21E0,X 

LDA $AOOE 

STA $21E2,X 

LDA$A010 

STA $2280,X 

LDA $A012 

STA $2282,X 

RTS 



On ne peut evidemment pas s'amuser k entrer les donnees des 
masques et des points de I'objet k la main ! Le mieux est d'^crire un 
petit programme, qui passe en revue tous les nibbles (tous les points) 
du futur sprite en construisant, pour chaque groupe de quatres points 
les instructions LDA, STA sauvegarde, AND masque, ORA donnees, 
STA image. Aucun exemple n'est donnd, car le programme varie de 
cas en cas (taille du sprite...)- De tels gen^rateurs de programmes 
representent un bon compromis place occupy sur disque/vitesse 
d'execution. II suffit de charger les donnees cies objets et de lancer le 
createur, ce dernier creant lui meme le programme dessinateur, qui 
n'a pas besoin d'etre sauvegarde ! Seul defaut, si Ton a plusieurs 
objets, la m^moire se remplit tr^s vite. Pour gagner encore un peu de 
temps, on peut utiliser la page zero pour charger et stocker les points 
du decor. Ce proced^ est avantageux si le sprite est large, car k cnaque 
changement de ligne, il faut rajouter $A0 au registre D, ce qui mange 
des cycles... 

Dans notre exemple, le sprite bouge de deux positions minimum dans 
les directions horizontals. Pour que ce mouvement devienne d'une 
position seulement, il faut avoir deux sprites et deux masques en 
memoire, et selectionner k chaque fois soit le sprite des positions 
paires, soit le sprite des positions impaires. Estimons-nous neureux, 
du temps de la resolution HGR de 1' Apple II, il ne fallait pas moins de 
sept sprites pour animer un objet ! 

Quand on g^re plusieurs objets, il faut veiller k les effacer dans I'ordre 
inverse de celui dans lequel ils ont ete dessin^s. Sinon, des motifs 
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bizares risquent d'apparaitre lorsque deux objets se chevauchent. 

Le nombre maximum d'objets gerables avec ce type de routine est tr^s 
limite. II est d' environ douze pour des sprites de seizepoints par seize 
points redessines k chaque balayage. Un moyen d'augmenter ce 
nombre est de reduire k la fois le champ de mouvement des sprites et 
leur frequence de modification, tout en utilisant le shadowing pour 
les redessiner (voir le paragraphe traitant du shadowing en tant 
qu'outil d' animation). 



4.3 SHADOWING dans I'animation 

Jusqu' h maintenant, nous a vons simplement utilise le SHADOWING 
de la page SUPER HIRES pour pouvoir travailler directement en banc 
01 , memoire rapide. Le shadowing peut egalement etre utilise comme 
outil d' animation, et ceci de deux mani^res differentes : 

- Admettons que nous animons beaucoup d'objets dans une partie 
seulement de I'ecran, et qu'il est impossiole de les dessiner tous le 
temps d'un balayage. Si on les dessine I'un apr^s I'autre directement 
sur la page affichee, I'animation ne sera pas nette. Une solution 
consiste h dessiner tous les objets dans la memoire en banc 01 avec le 
shadowing inactif, puis d'activer ce dernier et de recopier enti^re- 
ment ou partiellement la memoire du banc 01 sur elle-meme. Si la 
zone de recopie est restreinte, cette operation a des chances de se 
derouler en moins d'un balayage, amehorant ainsi considerablement 
I'animation. Cette technique peut etre utilisee pour faire apparaitre 
des menus deroulants presque instantanement, ces derniers etant 
tout d'abord dessines en banc 01 avec le shadowing inactif. 

- La deuxi^me cas ou le shadowing peut nous etre utile est celui ou Ton 
travaille avec un decor de fond. On peut, dans ce cas, avoir les 
donnees du decor en bancs 01 et $E1 et dessiner directement en banc 
$E1 . C'est un banc de memoire lente, mais pour certaines routines, ce 
n'est pas tr^s grave. Ce qui est interessant, c'est que Ton peut recopier 
le decor directement en recopiant la banc 01 sur lui-meme avec le 
shadowing actif. Cette technique est utilisable pour creer des generi- 
que, des textes apparaissent sur une image, puis ils sont effaces et 
d'autres les remplacent, I'image restant intact. 

Voyons maintenant les techniques de recopie rapide rapide de la 
memoire graphique du banc 01 sur elle-meme. On est tente d'utiliser 
des couples LDA/STA page zero, comme pour les scrolls. Cette 
mani^re d'agir est relativement rapide, mais dans ce cas precis, on 
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peut faire encore plus rapide. En utilisant I'instruction TSB (Test and 
Set Bit). Cette instruction execute 1' Equivalent d'un LDA et d'un ST A, 
tout en modifiant, en plus, certains bits du byte de travail, d'apr^s la 
valeur de ces bits dans I'accumulateur. Exemple : 

LDA $C068 
ORA #$30 
STA$C068 

Est equivalent k : 

LDA #$30 
TSB$C068 

Tous les bits ^ 1 de I'accumulateur sont mis h 1 dans la case memoire. 
(voir le chapitre sur les instructions du microprocesseur pour plus de 
renseignements) . 

Nous allons utiliser la version page zEro de cette instruction, qui ne 
prend que 5 cycles (6 en mode 16 bits), ce qui est tout bonnement 
ridicule ! Le programme de recopie de toute la page SUPER HIRES sur 
elle-meme serait done : 



PORGRAMME «RECOPIE RAPIDE» 



ORG $1800 ; En banc 01 



LOOP 
]POS 



CLC 
XCE 

SEP #$30 
STZ $C035 
LDA #$A1 
STA $C029 
LDA #$30 
TSB$C068 
REP #$30 
PHD 

LDA #$2000 

TCD 

LDA #$0000 

= $00 
LUP$80 



; Shadowing actif 
; Page aff ichee 

; Page. zEro en banc 01 

; 16 bits 
; Sauve D 

; Debut de la memoire 

; Necessaire que A=0000 
; pour ne pas perturber les 
; bits recopi^s 
; gen^re 128 instructions 
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]POS 



END 



TSB ]POS 


; de type TSB page z^ro 


= ]POS+2 




A 


; Boucle 


TDC 




CLC 




ADC #$100 




CMP #$9D00 


; = Fin de la memoire 


BEQ END 


; h copier 


BRL LOOP 




LDA #$30 


; Page zero k nouveau en 


■1KB $C068 


; banc 00 


PLD 


; Recup^re D 


RTL 


; Revient 



Cette routine doit etre placee en banc 01, on imagine qu'elle est 
appelee par un JSL depuis le banc 00. Pour copier toute la page, il lui 
faut environ : 128 instructions * 125 blocs de 256 bytes * 6 cycles/ 
instructions = 96000 cycles (en fait un tout petit peu plus). C'est tr^s 
peu, seulement deux balayage et demi, et encore moins si Ton recopie 
une partie de I'ecran seulement. 

Cette technique remplace sommairement la 2^me page graphique 
absente sur GS. 



Les deux programmes oui suivent sont des programmes prototypes, 
qui surpassent les possibilites «normales» du GS. 



4.4 Programme «MULTICOULEUR» 



Ce programme affiche 96 couleurs h I'ecran, en utilisant qu'une seule 
palette ! 

II est base sur 1' interruption SCANLINE (voir la description detaill^e 
de ces ev&nements dans le chapitre «SYNCHRONISATIONS»). Une 
interruption est generee k la ligne $30, puis le programme change la 
couleur 00 de la palette 00 k chaque debut de nouvelle ligne (les 
valeurs des couleurs sont stock^s dans les tables COLTBl et COLTB2). 
Pour ce faire, le programme poss^de une boucle d'attente dont le 
temps d'execution, additione avec le temps mis par la lecture des 
tables et le stockage des couleurs, correspond exactement au temps 
mis par le balayage pour parcourir une ligne. Avec ce principe, on 
peut imaginer plusieurs types d'effets : animations en modinant le 
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^S,^f i^^ ^^^^^f ^ ^^.^"l"^ interruption, changement de plusieurs 
ment des 16 couleurs d'une palette h chaque ligne (realisable en 

fsrlnT?^ ^t ?^^ ^" ^^"' ^^^* ^^ "*^"«^"t ^^ PeXs, voir le chapiSe 
it^^ ^H^^^^'I^^^ ^^ couleurs affichables simultan^ment k 

hgne; 200 lignes d'ecran Super Hires). Ce principe pourrait Jtre 
utilise pour archer sur I'ecran du GS des images proveSiit d'auSS 
machines a vec plus de 1 6 couleurs (images AMIG A 32 couleurs, VGA 
256 couleurs etc.). Cependant, le GS estlimit^ k 16 couleurs par ligne 
maximum qui ne pourra vraisemblablement jamais ^tre depassefcar 
le processeur vid^ du GS semble «lire», au dibut de chaque ligne, le 
rh^nT f ^ ^^P^^ette assignee. Ce qui sienifie que si I'on tente de 
changer la valeur d'une couleur lorsquele balayage est au milieu 
d une ligne, le changement ne sera pris en compte qu'^ la ligne 
suivante, lorsque la palette sera «rechargee». 4 « ^'^ ^^&i^ 

Cette tec 

couleurs 

termediaire 

ses inconvenients : 

H$t?!?lH^'S?'^ ^f gourmand en temps d'ex^cution, pour afficher ce 
degrade de 96 couleurs, il monopolise, en 60 HERZ, environ 100/262 
ment^lT'"dnf ! ^^""^^ ^" processeur. Mais I'effet en vaut certaine- 

65CR-\T^^^^^7^v ^^^^"i^Pprisation est calculi par rapport au 
£? 1 ^ MHZ. Pour tout changement de vitesse, meme^nime, 
i vpr Sn W ' ^ "f^na ^^' P^°biemes anparaitront done forcemen 
ayec 1 evolution du GS, qui se fera, on l^sp^re, avec un processeur 
plus rapide. Pour I'lnstant, le programme s'assure d^j^ qu'une carte 
acceleratrice «TRANSWARP (tmf» n'est pas presente etia d?ccSe 
SI il en trouve une (voir le chapitre «TRAksWARP») 
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«MULTICOULEUR» 



ORG $900 




CLC 




XCE 




SEP #$30 




LDA #$A1 




STA $C029 




REP #$30 




LDAL $BCFFOO 


; Cherche une carte 


CMP #'TW' 


; acc^leratrice 


BNE NOTR 


; TRANSWARP (tm) 


LDAL $BCFF02 


; et la met hors 


CMP #'GS' 


; d'usage le cas 


BNE NOl K 


; 6cheant 


LDA #$28 




JSL $BCFF24 




NOTR LDA #$0000 


; Efface I'ecran 


LDX #$'/EFE 




CLR STAL $E12000,X 




DEX 




DEX 




BPL CLR 




SEP #$30 




LDX #$C8 




CLILOP LDAL$E19D00-1,X 


; Met le bit 


AND #$BF 


; d' interruption de 
; tous les 9CB k 00 


STAL $E19D00-1,X 


DEX 


; pour n' avoir qu'une 


BNE CLILOP 


; seule interruption 


SEI 




LDAL $E19D30 


; Interruption h la 
; ligne $30 


ORA #$40 


STAL $E19D30 




LDA #$5C 


; Code pour JMPL 


STAL $E10028 




LDA #$00 




STAL $E1002B 




LDA #INTER 


; Adresse de la routine 


STAL $E10029 


; de gestion 
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LDA #>INTER 
STAL $E1002A 
LDA $C023 
ORA #$02 
STA $C023 
CLI 
RTS 

DS\ 



; d'interruption 

; Interruption engage 



; Elle peut avoir lieu. 
; Revient au moniteur 



INTER LDA $C032 
AND #$DF 
STA $C032 
LDY #$00 
JSRWAITl 

BARLOP LDACOLTBl,Y 
STA $C051 
NOP 
NOP 
NOP 
NOP 

LDA COLTBl,Y 
STAL $E19E00 
LDA COLTB2,Y 
STAL $E19E01 
JSRWAIT2 
INY 

CPY #$61 
BNE BARLOP 
CLC 
RTL 

WAITl LDX #$14 
Wl DEX 

BNEWl 

NOP 

NOP 

RTS 

WAIT2 LDX #$14 
W2 DEX 

BNEW2 

RTS 

DS\ 



; Signifie que I'interruption 
; est traits 



; Temporisation pr^liminaire 



; Temporisation 



; Encore temporisation ! 

; 97 couleurs seulement ! 

; Fin de Tinterruption 

; Retour k I'lnterrupt Manager 
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COLTBl 



COLTB2 



HEX 00,10,20,30,40,50,60,70 
HEX 80,90,A0,B0,C0,D0,E0,F0 
HEX F0,F0,F0,F0,F0,F0,F0,F0 
HEX F0,F1,F2,F3,F4,F5,F6,F7 
HEX F8,F9,FA,FB,FC,FD,FE,FF 
HEX FF,EF,DF,CF,BF,AF,9F,8F 
HEX 7F,6F,5F,4F,3F,2F,1F,0F 
HEX 0F,0F,0F,0F,0F,0F,0F,0F 
HEX 0F,0F,0F,0F,0F,0F,0F,0F 
HEX 0F,0E,0D,0C,0B,0A,09,08 
HEX 07,06,05,04,03,02,01,00 
HEX 00 



HEX 0F,0F,0F,0F,0F,0F,0F,0F 
HEX 0F,0F,0F,0F,0F,0F,0F,0F 
HEX 0F,0E,0D,0C,0B,0A,09,08 
HEX 07,06,05,04,03,02,01,00 
HEX 00,00,00,00,00,00,00,00 
HEX 00,00,00,00,00,00,00,00 
HEX 00,00,00,00,00,00,00,00 
HEX 00,00,00,00,00,00,00,00 
HEX 00,01,02,03,04,05,06,07 
HEX 08,09,0A,0B,0C,0D,0E,0F 
HEX 0F,0F,0F,0F,0F,0F,0F,0F 
HEX 0F,0F,0F,0F,0F,0F,0F,0F 
HEX 00 
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4.5 Prgramme «ENTRELACAGE» 



Le nombre de couleurs differentes que peut gen^rer le processeur 
video du GS est de 4096 (RGB 12 bits, 4 bits = 16 valeurs par compo- 
sante, 1 6^3 = 4096). Un moyenpour augmenter ce nombre est de cr^r 
des demi intensites. Pour ce faire, il suffit de changer I'intensite d'une 
couleur un balayage sur deux. Si par exemple on a un rouge d'inten- 
sit& 2 que Ton fait passer ^ 3 au balayage suivant, pour la remettre h 
2 au balayage d'apr^s, la couleur effectivement pergue sera un rouge 
2.5. En utilisant ce proced^, on peut gen^rer jusqu'^ 31 intensites 
differentes pour chaque composante, nous authorisant : 31 ^^3 = 29791 
couleurs ! 

Ce qui multiplie par plus de 7 le nombre de couleurs de base. Cette 
technique pourrait s'appeler «ENTRELACAGE COULEUR» par 
analogie avec I'entrelagage tout court. Un mode graphique entrelace 
possede plus de lignes en hauteur qu'un mode traditionnel (en 
general 400 ou 512), chaque ligne n'est alors rafraichie qu'une fois 
tous les deux balayages, creant un scintillement generalise. Le mode 
entrelace couleur a simplement un certain nombre de couleurs qui ne 
retrouvent une meme valeur que tous les deux balayages, un leger 
scintillement en resulte, plus marque en 50 HZ qu'en 60 HZ(frequence 
de rafraichissement plus faible). 

Le programme qui suit est un bon exemple d'entrelaqage couleur, il 
montre la difference entre un degrade compose de 16 nuances de 
rouge et le meme degrade avec 31 nuances. Une fois lance, un degrade 
entrelace de 31 rouges apparait, en appuyant sur une touche, on passe 
du mode 31 au mode 16 et vice-versa. La difference saute aux yeux, 
les 31 nuances donnent un degrade beaucoup plus lisse, legerement 
scintillant. 

Le principe d'execution est le suivant : 

Le programme commence par dessiner deux lignes avec chaque 

couleur de 1 ^ 16, ce qui donne les sequences suivantes (en bytes) : 

mil mil 1111111111 ... 
mil mil 1111111111 ... 

22222 22222 22222 22222 . . . 
22222 22222 22222 22222 . . . 



FFFFFFFFFFFFFFFFFFFF . . . 
FFFFFFFFFFFFFFFFFFFF . . . 



En mode 16 intensites, chacune des couleurs possede I'intensite cor- 
respondant h son numero, on a done deux lignes pour chaque 
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intensite. Lorsque I'entrelagage est activ^ une seconde palette est 
assignee k la deuxi^me ligne de chaque couleur, un balayage sur 
deux. Dans cette seconde palette toutes les couleurs sont plus efev^s 
d'une intensite de rouge. La deuxi^me ligne de chacune des couleurs 
aura done une intensite comprise entre son num^ro et un numdro plus 
eleve. Ce programme est donn^ plus en tant que curiosite qu'en tant 
qu'utilitaire. Mais si Ton repense k notre programme 16 couleurs par 
ligne qui devait nous permettre d'afficher des images en provenance 
dT)rdinateurs aux processeurs videos plus performants, on se rend 
compte que ce mode entrelac^ pourrait nous rendre service. Non pas 
au niveau du nombre de couleurs simultan^s h I'^cran, mais plutdt 
au niveau du nombre de couleurs s^lectionnables, le RGB 24 bits (8 
bits, 256 niveaux par composante, 16 millions de couleurs affichables) 
etant une realite sur des machines comme le Macintosh II (tm Apple 
Computer). 

ORG $900 

STATUS =$00 
LACE = $01 



CLC 
XCE 

SEP #$30 
LDA #$A1 
STA $C029 
STZ STATUS 
STZ LACE 



; Super hires affich^ 

; Variables du programme 



REP #$30 

LDX #$7FFE ; Efface la page graphique 
LDA #$0000 
CLR STAL $E12000,X 

DEX 
DEX 
BPL CLR 



SEP #$20 



; A 8 bits, X,Y 16 bits 



LOOP2 
LOOPl 



LDA #$11 
LDX #$33E0 
LDY #$0140 
STAL $E12000,X 
INX 
DEY 



; Premiere ligne, couleur 1 
; Adresse de la l^re ligne 
; 2 lignes = $140 bytes 
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LOOP3 



Wl 

W2 



CONT 
PALO 



BNE LOOPl 
CLC 

ADC #$11 
CMP #$10 
BNE LOOP2 



; Couleur suivante, byte + $11 



SEP #$10 

LDA #$00 

LDX #$01 

STAL $E19E00,X 

STAL $E19E22,X 

INX 

INX 

INC 

CMP #$10 

BNE LOOP3 

LDA $C019 

BMIWl 

LDA $C019 

BPLW2 



; A,X et Y 8 bits 

; Creation des deux palettes 

; palette 00 
; palette 01 



; Attend la fin de 

; I'ecran 

; (voir SYNCHROS) 



LDA $C000 
BPL CONT 
BIT $C010 
LDA LACE 
EOR #$01 
STA LACE 



; Attend une touche au 
; clavier 

; Si une touche est appuy^, 
; change de mode : 
; normal ou entrelac^ 



LDX #$21 ; Remet la palette h 00 

LDA #$00 ; sur toutes les lignes 

STAL$E19D53,X ; du dessin 

BPL PALO 



LDA LACE 
BNEWl 



; Si lace <> 00 alors pas de 

; mode entrelace, retour au debut 
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LDA STATUS 
EOR #$01 
STA STATUS 
BNE PALOl 

BRAWl 



Sinon, changement du 

status pour la prochaine 

fois 

et peut §tre changement 

de palette une ligne sur 

deux 



PALOl LDX #$00 ; Palette 01 assignee une 

LDA #$01 ; ligne sur deux 

LOOP4 STAL $E19D53,X ; Cette routine n'est 

INX ; executee qu'un balayage sur deux 

INX 

CPX #$22 

BNE LOOP4 

BRAWl ;Etga continue!!!! 

4.6. Format des images svu: disk 



Deux formats principaux existent : 

- Le format PIC (f ichier type $C1 ). Ce format est le plus simple, I'image 
est directement stockee sous forme d'un bloc m^moire non compacte, 
contenant donnees, table SCB et palettes. On peut le charger en banc 
00, $1000 et I'afficher avec le programme «COPIE». 

- Le format PNT (type $C0) qui est en fait compose de plusieurs sous- 
format. Chaque sous-format (identifiable par un type auxiliaire, 
AUXTYPE, different: 00,01,02..) a sa particularity dVganisation. 
Tous les fichiers de type $C0 sont compactes, compl^tement ou 
partiellement, par I'outil N 26 de la TOOLBOX. 

Si Ton veut utiliser une image de type $C0, on peut soit se servir du 
decompresseur ad^quat (disponible dans le domaine public), soit 
utiliser un programme d'affichage d' images ou un programme de 
dessin, puis sauver la zone memoire de I'ima^e (en utilisant le 
programme «COPIE» par exemple). Pour r^cuperer les images des 
programmes du commerce, qui utilisent souvent leur propre com- 
presseuT- et des images sous forme de fichiers binaires, la technique 
decrite precedemment fonctionne parfaitement. II suffit d'interrom- 
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pre le programme (par un CTRL-RESET, ou h I'aide de I'option VISIT 
MONITEUR installable dans le CONTROL PANEL), puis de lancer le 
programme «COPIE» et de sauver I'image maintenant en banc 00. 

En exernple, voila un programme de decompression d'images au 
format $C0, type GS-PAINT, dmulant I'outil N 26. 11 est donn^ assem- 
ble en $2000, et il attend I'image compact^ en $2100. Ces valeurs 
peuvent etre modifiees tr^s facilement. 

Exemple d'un programme BASIC pour charger & d^compacter une 
image : 

10 PRINT CHR$(4);»BLOAD IMAGE,A$2100,T$C0" 
20 PRINT CHR$(4);»BRUN DECOMPACTEUR» 

DECOMPACTEUR 



ORG $2000 

LDA #$A1 
STA $C029 
STZ $EB 
STZ $ED 
STZ $FA 

LDA #$21 ; Adresse de I'image 

STA $EC ; compactee ($21 00) 

LDA #$20 
STA $EE 
CLC 
XCE 

REP #$10 
PHB 

LDA #$00 
XBA 

LDA #$1F 
LDX $EB 
LDY #$9E00 
MVN $000000,$E10000 
LDX #$00C7 
CLR STZ $9D00,X 

DEX 

BPL CLR 
PLB 
LDA #$22 
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STA $EB 
CLC 

LDA $EC 
ADC #$02 
STA $EC 
LOOP LDA ($EB) 
CMP #$40 
BCCL5 
CMP #$C0 
BCSLl 
CMP #$80 
BCSL4 
AND #$0F 
INC 
BRAL3 

LI SEC 

SBC #$3F 

ASL 

ASL 

L3 STA $EF 

JSR INCR 

L2 LDA ($EB) 

LDY #$00E1 
PHY 
PLB 

STA ($ED) 
PLB 

JSR INCR2 
DEC $EF 
BNEL2 
JSR INCR 
BRA LOOP 

L4 SEC 

SBC #$80 
STA $FA 
LDA #$03 

L5 STA $EF 

JSR INCR 

L6 PHB 



LDA #$00 

XBA 

LDA $EF 

LDX$EB 

LDY $ED 

MVN $000000,$E10000 
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L7 



L8 



INCR 

RET 

INCR2 



NOEND 



PLB 

JSR INCR2 
LDA $FA 
BNEL8 
JSR INCR 
DEC $EF 
BPLL7 
LDA #$03 
STA $EF 
DEC $FA 
BPLL6 
STZ $FA 
BRA LOOP 

INC $EB 
BNE RET 
INC$EC 
RTS 

INC$ED 

BNE NOEND 

INC$EE 

LDA $EE 

CMP #$9D 

BNE NOEND 

PLX 

SEC 

XCE 

RTS 



; Fin si on atteint 
; $9D00 



4.7 TRANSWARP GS 



La carte TRANSWARP GS, commercialisee par la society americaine 
Applied Engineering, est une carte acceleratrice pour 1' Apple Ilgs. 
Avec cette carte installee (comprenant son propre microprocesseur 
ainsi que de la memoire cache), la vitesse de la machine est poussee 
^ 6 ou 7 MHZ. Cette vitesse augmentee est fort appreciable pour 
certaines applications (calculs en particulier), mais peut s'av^rer 
nefaste pour certaines anin^ations graphiques ayant des temporisa- 
tions precises (le programme «MULTICOULEuR» en est un des 
meilleurs exemples). 11 est toujours possible d'inclure aux program- 
mes en question un message preliminaire invitant I'utilisateur k 
ralentir son GS avant execution. Mais on peut egalement d^tecter la 
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carte et la ralentir directement ! Void un petit programme qui s'en 
charge : 



SAVSPEED = $00 ; Adresse de sauvegarde 

; Passe en mode 16 bits 



CLC 
XCE 

REP #$30 



STZ SAVSPEED ; Met la sauvegarde h zero 



LDAL $BCFFOO 

CMP "TW" 

BNE :1 

LDAL $BCFF02 

CMP "GS" 

BNE:1 

JSL $BCFF20 

STA SAVSPEED 



JSL $BCFF24 



Marque de la presence de la 
TRANSWARP : la sequence 
'TWG" = $54574753 
k I'adresse $BCFF00 

Si la carte est presente. 
On regarde la vitesse 
et on la sauve. LDA #$28 
On force la vitesse k 2.8 
MHZ, vitesse du processeur 
d'un GS en mode FAST 



PROGRAMME PRINCIPAL 



REP #$30 

LDA SAVSPEED 

BEQ:2 

JSL $BCFF24 

RTS 



; Fin, passage en 16 bits 
; Si SAVSPEED=00, pas de 
; TRANSWARP, on sort 
; Sinon, on remet la vitesse 
; avant de sortir 
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$BCFF20 - GETSPEED, On r^cup^re la vitesse dans A 16 bits 
$BCFF24 - STORESPEED, On force la vitesse contenue dans A 

II existe encore d'autres appels possibles, entre autres pour connaitre 
les vitesses disponibles... Mais ces 2 suffisent amplement. Un dernier 
mot sur la TRANSW ARP : cette carte possdde de la m^moire cache, ce 
qui signifie que I'effet accel^rateur sera meilleur lorsque le pro- 
gramme execute «bouclera» dans une zone m^moire plus petite que 
32k. II faut eviter, dans ce cas, d'avoir des morceaux de programmes 
dans tous les bancs et de les appeler les uns apr^s les autres, sous peine 
de voir le facteur d' acceleration chuter. De meme, la TRANSWARP 
n'accel^re pas les operations de stockage en m^moire lente, ni le 
SHADOWING, elle n'aura done pas des effets aussi spectaculaires 
sur les animations graphiques en SUPER HIRES que sur les program- 
mes en mode texte, par exemple. 



4.8 CONCLUSIONS 



Nous avons fait le tour de toutes les possibilites graphiques de base 
du GS, nous avons vu comment aller au delk de ces dernieres k I'aide 
de techniaues de programmations speciales. II est temps de faire un 
bilan, et de comparer le GS k ses concurrents, d'un point de vue 
graphique. 



Machine 


Resolution 


Nb couleurs 


RGB 


GS 
GS 


320*200 
640*200 


16 *1 
04 


12 bits 


ST 
ST 
ST 


320*200 
640*200 
640*400 


16 

04 *2 
02 


9 bits 


AMIGA 
AMIGA 
AMIGA 


320 * 200 *3 
640 * 400 
320*400 


32 
16 
4096 *4 


12 bits 



*1 Et non pas 256, car la majority des programmes de dessin ne g^rent 

que 16 couleurs 

*2 Le ST «classique» est consider^ ici, et non pas le nouveau 

*3 Le nombre de lignes en PAL peut etre etendu ^ 256 et 512 respec- 

tivement ^ 

*4 avec beaucoup de restrictions (mode HAM) 
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II ressort de cette comparaison les faits suivants : 

- Le GS est la seule machine h ne pas posseder de mode 400 lignes (que 
ce soit sur un MULTISYNC en noir & blanc comme pour le ST ou alors 
sur un moniteur normal en mode entrelace comme 1' AMIGA) 

- Le GS semble avoir un avantage sur le ST, ce dernier ne poss^dant 
qu'un mode RGB 9 bits (3 bit = 8 valeurs par composantes, 512 
couleurs maximum) 

- Les possibilites «normales» de ces trois machines en mode 320 sont 
relativement proches (en excluant le mode HAM de 1' AMIGA, qui est 

une particularite) 

A la lumifere de ces considerations, le GS ne semble pas en arri^re par 
rapport k ses concurrents. Alors comment se fait-il que les animations 
sur GS semblent si derisoires par rapport h des animations AMIGA ou 
meme ST ? 

La reponse est h chercher k la fois dans I'absence d'un co-processeur 
graphique valable (1' Amiga en poss^de deux) et dans la lenteur du 
65C816. 2.8 MHZ represente une augmentation de vitesse de 2.8 fois 
par rapport k I'Appie II alors que la taille d'une page graphique a 
Quadruplee, passant de 8 ^ 32k ! Tout le monde semble d' accord pour 
aire que la Vitesse du GS devrait etre de 8 MHZ . 

Les choses k regretter quant au processeur graphique sont les suivan- 
tes : 

L'impossibilite de changer la position en memoire de la page graphi- 
que, et surtout son positionnement en memoire lente ! 
L' absence de mode 400 lignes 

L'impossibilite d' avoir des caract^res de couleurs differentes en 
mode TEXT 

La limitation du nombre de couleurs de la bordure k seize 
L'absence d'un mode «PAL» 256 lignes 

Le fait que les valeurs des couleurs cr une palette ne soient lues qu'une 
fois, en debut de ligne 
Sa trop grande simplicite. 



Interpretons tous ces limitations comme un encouragement k aller le 
plus loin possible avec ce qui nous est donn6, quelles que soient les 
techniques employees. 
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V 



GS/OS 



5.0 Introduction a GS/OS & Prodos 8 

Nous allons etudier dans cette partie deux syst^mes d' exploitation 
fonctionnant sur Apple II GS : GS/OS (GS Operating System), le 
syst^me d'exuloitation 16 bits de 1' Apple II GS, et le ProDos 8 (Profes- 
sional Disk Operating System), le syst^me d'exploitation 8 bits de 
1' Apple II et de 1' Apple II GS. 

GS/OS est le premier syst^me d'exploitation qui exploite 1' Apple II 
GS dote de ROM 01 ou de ROM superieure. II ne fonctionne sur aucun 
autre module de la famille Apple que 1' Apple II GS. GS/OS exploite 
les caracteristiques les plus avancees du microprocesseur 16 bits 
65C816 du II GS. C'est le syst^me d'exploitation qui a remplace 
ProDos 16, un syst^me d'exploitation d'attente qu' Apple a foumi h 
I'introduction sur le marche de 1' Apple II GS de Septembre 1 986 ^ Sep- 
tembre 1988. Pour des raisons de compatibilite, GS/OS reconnait 
toutes les commandes de ProDos 16, afin que les applications ecrites 
pour fonctionner sous ProDos 16 continuent de fonctionner correcte- 
ment sous GS/OS. ProDos 8 fonctionne sur les ordinateurs APPLE 
II+, He, et lie. II fonctionne aussi sur Apple II GS quand celui-ci est en 
mode emulation; vous pouvez passer du GS/OS au ProDos 8 si GS/ 
OS est le systfeme d'exploitation utilise pour booter le GS. ProDos 8 est 
un systfeme d'exploitation ecrit en 8 bits fonctionnant avec les micro- 
processeurs 6502 et 65C02. La plupart des commandes ProDos 8 ont 
un equivalent sous GS/OS, mais la methode pour mettre en oeuvre la 
commande est differente, du moins pour les programmes en langage 
machine. 

GS/OS et ProDos 8, comme tous les autres syst^mes d'exploitation 
g&rent les donnees allant et provenant d'un support magnetique 
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comme par exemple une disquette 5.25, une disquette 3.50 ou un 
disque dnr. lis font ce travail en traduisant des commandes disque de 
haut niveau utilis^es par un programn\e d' application en instructions 
de bas niveau n^cessaires pour communiquer directement avec le 
controleur de disque. Le syst^me d'exploitation utilise aussi des 
groupes de donnees structur^es appeles fichiers. 

GS/OS et ProDos 8 fonctionnent parfaitement avec tous les p6riphe- 
riques disaue qu' Apple a vendu pour la f amille Apple II : le Drive 5.25 
(et ses preaecesseurs), le disque dur HD20SC, I'UniDisk 3.5, le lecteur 
Apple 3.5, la carte d' extension memoire Apple II (utilisee en RamDis- 
que), et le lecteur APPLE CD SC CD-ROM; 

5.0.1 Les syst^nnes d'exploitation sur Apple n - Une longue histoire 

Quand Apple s'est lance dans I'aventure en 1977, le magnetophone et 
sps ra<;<;pHp<; M^if 1p <:pii1 ''npripVi^rimip" non''" sforWpr 'V>n. macQp'' lee 
donnees des utilisateurs. La raison en est simple : le premier Apple II 

disposait d'un port cassette, ce qui facilitait la connection d'un ma- 
gnetophone k cassette jusqu'^ I'invention du lecteur de disquettes et 
de sa carte controleur. 

Travailler avec une cassette pour stocker ses donnas n'^tait pas de 
tout repos. Les temps de chargement 6taient tr^s lents, et I'utilisateur 
n'etait jamais certain de retrouver ses precieuses donnas. Pour 
rendre 1' Apple II de ces temps h^roiques aussi pratique qu'un ordina- 
teur compatible d'aujourd'nui, on ne pouvait pas donner de nom aux 
fichiers et pour le chargement d'un fichier en particulier, il fallait au 
pr^alable positionner m^ticuleusement la cassette k I'endroit strategi- 
que du debut de I'enregistrement du dit fichier. 

Steve Wozniak, I'inventeur de 1' Apple II fut bien evidemment le 
premier que cette situation rendait extr^mement nerveux. Au cours 
de I'hiver 1977-1978, il a congu une carte d' extension capable d'inter- 
facer un Apple II et un lecteur de disauettes qu'on a appel^ plus tard 
le Disk II. Au meme moment. Bob Snepardson, et plus tard Randy 
Wigginton, Dick Huston, et Rick Auricchio, 6taient en train d'^crire 
un syst^me d'exploitation qui permettrait aux programmeurs de 
creer, organiser, et acceder h des fichiers sur les disques souples 5.25 
que ce lecteur (le Disk II) allait utiliser. 

Apple a en fait livre le Disk H, sa carte controleur, et la premiere 
version du syst^me d'exploitation (DOS 3.1) au tout debut de I'ete 
1978. Ce lecteur, le Disk II a et^ bien plus tard renomm^ Unidisk, puis 
lecteur Apple 5.25. Ce fut probablement I'^v^nement le plus impor- 
tant de la courte histoire d' Apple, car cela signifiait que pour la 
premiere fois des logiciels professionnels pouvaient etre Merits pour 
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un ordinateur de type Apple II. De tels lo^iciels n^cessitent de creer 
et de manipuler des fichiers de donn^es importants rapidement et 
facilement, une prouesse qu'il ^tait impossible de realiser avec une 
cassette et un magnetophone. 

Plusieurs modifications ont eti apport^s au DOS 3.1 dans les mois 
Qui ont suivi sa sortie pour corriger les inevitables bugs qui fretillaient 
dans tout le syst^me a'exploitation. Le DOS s'est finalement stabilise 
k la version 3.2.1 au milieu de I'annee 1979. Cette premiere version du 
DOS formattaient des disquettes en 35 pistes (I'utilisation d'une 
366me piste est une particularite du Disk n qui n'a s^duit que 
quelques partisans avides de succ^s ...), chacune contenant 13 sec- 
teurs de 256 octets (soit done un total de 133.75 Ko, oCil Ko = 1024 
octets). En fait, le programme situ^ sur la Rom de cette carte contrd- 
leur ne pouvaitbooter que les disquettes utilisant ce format sp^cifique 
en 13 secteurs. 

C'est egalement en 1979 qu' Apple a sorti son syst^me d'exploitation 
Pascal. Ce syst^me g^re les fichiers d'une mani^re tout h faitdiff^rente 
des syst^mes DOS 3.x ou plus tard ProDos. Pour transferer des 
fichiers texte Pascal sur une disquette DOS (ou inversement), vous 
pouvez utiliser des programmes utilitaires disponibles dans le com- 
merce ou aupr^s des clubs d'utilisateurs. 

Apple a mis k jour le DOS 3:2,1 en 1%Q gfin qy'i} py}§§g g^j^i Ig 

nouveau syst^me de formatage en 16 secteurs (ce n'est pas Apple qui 
a invente le 18 secteurs ...) utilise par son syst^me d'expfoitation 
Pascal. Le resultat f ut le DOS 3.3, une version du DOS encore en cours 
quand Apple a sorti ProDos 8 au tout d^but de 1984. Le formatage 
etant different, cela a n^cessit^ un chaneement de ROM sur la carte 
controleur. Le principal avantage de ce cnangement de formatage fut 
de pouvoir utiliser 26.25 Ko suppl^mentaire sur le disque 5.25 (pour 
un total de 140 Ko : ceux des lecteurs qui n'ont pas saisis peuvent 
immediatement retourner k la lecture des manuels Apple ou s'adres- 
ser ^ E. S. chez Apple France). L' inconvenient de taille 6tait que le DOS 
3.3 ne pouvait pas directement lire les fichiers situes sur une disquette 
formatee en DOS 3.2.1; de plus, il n'^tait pas possible de booter les 
disques formates en DOS 3.2.1 sur une carte controleur 6quipee de 
cette nouvelle Rom. Heureusement, Apple a cr^ un programme 
appele MUFFIN pour transferer des fichiers de I'ancien format (13 
secteurs) au nouveau format (16 secteurs). H est int^ressant de cons- 
tater que c'est k partir de MUFFIN que les pirates de I'^poque ont 
puise nombre de connaissances pour deplomber les disquettes utili- 
sant une protection alterant le formatage. Apple a creer un deuxi^me 
programme BOOT13 afin que I'utilisateur puisse booter des disques 
formates en DOS 3.2.1 avec le nouveau contrdleur de disques. 
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Apple a sorti Pro Dos 8 que Ton appelle maintenant ProDos en Janvier 
1984. II fonctionne sur tous les Apple He, Apple lie, ou Apple II GS ou 
sur un Apple II Plus muni d'une carte d' extension m^moire de 16 Ko 
en slot 0. II fonctionne aussi sur 1' Apple II de I'age de pierre muni 
d'une carte d'extension Ram de 16 Ko, seulement si le Basic Apple- 
soft, et non pas le BASIC Integer est present en ROM. A la sortie de 
ProDos 8, Apple a precise qu'il ne sortirait plus de logiciels utilisant 
le DOS 3.3; Apple a recommand^ aux developpeurs independants 
d'en faire de meme. 6 ans apr^s, certains editeurs de logiciels et 
constructeurs de disques durs ne connaissent toujours pas ProDos ... 

Une carte controleur compatible ProDos 8 pour le disque dur ProFile 
qu' Apple avait realise deux ans auparavant pour etre utilise sur 
Apple III a ete mise sur le marche en Janvier 1984. ProDos 8 est capable 
de gerer des volumes d'une taille allant iusqu'^ 32 Mega-octets. Ce 
n'est que plus tard qu' Apple a remplac6 le ProFile par le disque dur 
HD20SC a'une capacite de 20 Mega-octets, un peripnerique SCSI. On 
le connecte k I'orainateur au moyen d'une carte a interface SCSI. 

En Septembre 1985, le lecteur UniDisk 3.5 a fait sa premiere appari- 
tion, it utilise des disquettes au format 3.50 pouces enveloppees a'une 
protection en plastique; leur capacite de stockage est ae 800 Ko. 
^roDos 8 reconnait automatiquement la carte controleur de ce type de 
ecteur de disquettes, aucun Driver n'est k installer. C'est k cette 
epoque qu' Apple a commence k fabriquer les Apple lie avec un 
controleur de lecteur 3.50 integre. Apple a aussi developp^ k la meme 
epoque une carte d'extension memoire que ProDos 8 reconnait en 
Ram Disque au moment du boot. 

Apple a annonce 1' Apple II GS en Septembre 1986. A ce moment, 
Apple a renomme ProDos par ProDos 8, et a realise ProDos 16 un 
syst^me d' exploitation speafique k 1' Apple II GS. Bien que ProDos 16 
formate les disques et stocke les fichiers de la meme mani^re que 
ProDos 8 (ce qui signifie que les deux syst^mes d' exploitation peu- 
vent co-exister sur le meme disque), les deux syst^mes sont tout k fait 
incompatibles au niveau de la programmation. Apple a realise le 
ProDos 16 pour exploiter pleinement la capacite a'adressage du 
65C816; ProDos 8 travaille seulement avec une capacite memoire de 
64 Ko. En meme temps que 1' Apple II GS, le lecteur Apple 3.5, un autre 
lecteur utilisant des disquettes 3.50 pouces a fait son apparition. La 
difference entre Apple 3.5 et I'UniDisk 3.5 est que le premier n'a pas 
de processeur intelligent integre, et que par consequent il ne fonc- 
tionne que sur 1' Apple II GS. 

Une autre version de I'Apple He est sortie en Septembre 1986. II 
comprend un connecteur sur lequel on peut enficher une carte d'ex- 
tension memoire. ProDos 8 reconnait cette carte en RamDisque. 
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En Septembre 1988, Apple a realise GS/OS, un nouveau syst^me 
d'exploitation pour le II GS destine k remplacer ProDos 16. GS/OS est 
bien entendu compatible avec le ProDos 16. II comprend des nouvel- 
les commandes qui sont plus puissantes que celles de ProDos 16. line 
caracteristique tr^s iniportante est que GS/OS peut acceder k des 
disques formates sous ProDos et h des disques formates avec un autre 
systeme d'exploitation comme par exemple le High Sierra (pour les 
CD Roms), le HFS (utilise par le Macintosh), ou le MS-DOS. Pour 
avoir acc^s h un autre systdme d'exploitation, il suffit de placer un 
module FST (File System Translator) sur le disque syst^me GS/OS. 
Pour le moment, Apple a fourni les modules FST pour les syst^mes 
ProDos et High Sierra. 

Un autre module d' Apple lie, 1' Apple lie Plus a egalement vu le jour 
en Septembre 1988. II incorpore un lecteur de disquettes 3.5 qui 
fonctionne avec ProDos 8. 

Les premieres versions de ProDos avaient des bugs mineurs mais 
embetants c^ui furent corriges dans les versions ulterieures. Au mo- 
ment de la redaction de ces Rgnes, la version ayant cours est la 1 .7. GS/ 
OS, syst^me d'exploitation beaucoup plus complexe, n'est pas encore 
tr^s stable au contraire de ProDos 8. Apple va en sortir de nouvelles 
versions environ deux fois par an... 

5.0.2 Comparaison du ProDos 8 et du DOS 3.3 

Le DOS 3.3 est constitue de deux modules principaux : le driver I/O 
(Input/Output) qui communique directement avec le controleur de 
disque 5.25, et 1' inter preteur de commande Applesoft qui analyse et 
execute les commandes disque du Basic Applesoft que le DOS 3.3 
permet (OPEN, READ, CATALOG, etc ...). Les modules Equivalents 
dans ProDos 8 sont separes en deux fichiers programme appeles 
PRODOS (le driver I/O) et BASIC.SYSTEM (I'interpreteur de com- 
mande Applesoft). Dans laplupart des applications, ProDos 8 charge 
directement BASIC.SYSTEM au moment oil le disque boote. Le 
tableau suivant decrit brievement les commandes disque permises 
sous BASIC.SYSTEM et DOS 3.3. La plupart de ces commandes sont 
disponibles sous les deux syst^mes, certaines etant specifiques k I'un 
ou V autre des syst^mes d'exploitation. En general, les commandes 
BASIC.SYSTEM sont plus puissantes que leur Equivalent en DOS 3.3 
car elles acceptent un nombre important de paramEtres. Faites atten- 
tion, car quelques commandes ne jouent pas le meme rdle d'un 
systEme d exploitation k I'autre. 



copyright Tooflioil990 261 



5.0.3 Comparaison des commandes disque Applesoft. 



BASIC.SYSTEM-DOS 3.3 



COMMANDES 



DESCRIPTION 



P8 DOS 3.3 



APPEND 


Ouvrir un fichier pour y ajouter des datas 


OUI 


OUI 


BLOAD 


Charger un fichier 


OUI 


OUI 


BRUN 


Charger et executer un prog, binaire 


OUI 


OUI 


BSAVE 


Sauvegarder un fichier 


OUI 


OUI 


CATALOG 


Lister les fichiers du volume (forme longue) 


OUI 


OUI 


CLOSE 


Fermer un fichier 


OUI 


OUI 


DELETE 


Effacer un fichier 


OUI 


OUI 


EXEC 


Executer des commandes d'un fichier Texte 


OUI 


OUI 


IN# 


Rediriger I'entree de caract^res 


OUI 


OUI 


LOAD 


Charger un programme Applesoft 


OUI 


OUI 


LOCK 


Verouiller un fichier 


OUI 


OUI 


NOMON 


(Permis mais ignorer sous ProDos 8) 


OUI 


OUI 


OPEN 


Ouvrir un fichier 


OUI 


OUI 


POSITION 


Preparer lecture ou 6criture k une position 


OUI 


OUI 


PR# 


Rediriger la sortie de caract&res 


OUI 


OUI 


READ 


Lecture h partir d'un fichier 


OUI 


OUI 


RENAME 


Renommer un fichier 


OUI 


OUI 


RUN 


Charger et executer un prog. Applesoft 


OUI 


OUI 


SAVE 


Sauvegarder un prog. Applesoft 


OUI 


OUI 


UNLOCK 


Deverrouiller un fichier 


OUI 


OUI 


VERIFY 


Verifiez I'existence d'un fichier 


OUI 


OUI 
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WRITE 

BYE 

CAT 

CHAIN 

CREATE 

FLUSH 

PRE 

PREHX 

RESTORE 

STORE 

FP 

INIT 

INT 

MAXHLES 

MON 



Ecrire un fichier 

Execute un fichier Applesoft, BIN, TXT, SYS 

Transferer le contrdle k un autre prog. SYS 

Lister les fichiers du volume (forme courte) 

Transferer le Ctrl k un autre prog. Applesoft 

Creer un fichier 

Ecrire les contenus des buffers fichier 

Faire le menage des chaines en memoire 

Donner le nom du catalogue actif 

Recuperer les variables d'un prog. Basic 

Sauvegarder les variables d'un prog. Basic 

Initialiser le mode Applesoft 

Formater une disquette 

Initialiser le mode BASIC Integer 

Creer de I'espace pour les buffers fichier 

Permet I'affichage des Of)erations du DOS 



OUI 


OUI 


OUI 


NON 


OUI 


NON 


OUI 


NON 


OUI 


NON 


OUI 


NON 


OUI 


NON 


OUI 


NON 


OUI 


NON 


OUI 


NON 


OUI 


NON 


NON 


OUI 


NON 


OUI 


NON 


OUI 


NON 


OUI 


NON 


OUI 



n n'est pas surprenant de constater, que renvironnement PRODOr + 
BASIC.SYSTEM est plus gourmand en memoire que le DOS 3.3. Le 
syst^me PRODOS + BASIC SYSTEM utilise presque deux fois plus de 
memoire que le DOS 3.3. Heureusement, la plupart du ProDos 8 
reside dans une Bank Ram de 16 Ko commutable et n'est done pas en 
conflit avec I'espace memoire utilise par I'interpreteur Applesoft. Cet 
espace memoire commutable est integre sur les Apple lie, lie et II GS 
et peut -etre ajoute sur les Apple II ou Apple II Plus en ins tall -nt une 
carte d'extension memoire ae 16 Ko dans le slot de I'ordinateur : il 
s'agit de la carte langage, creee au moment du developpeme^t du 
syst^me d'exploitation Pascal sur Apple II qui necessitait de la 
memoire supplementaire. II y a deux effets secondaires dus k I'utili- 
sation de la carte langage par le ProDos. Premi^remer ^ ProDos ne 
peut pas co-exister avec un programme qui utilise la carte lan^ ge par 
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lui meme, ou pour y ranger des donnees. Deuxi^mement, le Basic 
Integer ne peut plus etre utilise, car il se loge en carte langage : paix k 
ses cendres. 

Une autre grande difference entre DOS 3.3 et BASIC .SYSTEM est dans 
la mani^re de prendre en charge les buffers pour les fichiers. Un buffer 
fichier est une zone de memoire qu'un fichier va utiliser; ce buffer 
contient les donnees contenues dans la partie active de ce fichier ainsi 
que information necessaire k la localisation de ce fichier sur disque. 
Quand le DOS 3.3 se lance, il initialise automatiquement trois de ces 
buffers; un nombre different de buffers peut etre reserve (de 1 ^ 16) en 
utilisant la commande M AXFILES. Les buffers fichier du DOS 3.3 ont 
chacun une longueur de 595 octets et sont situes entre le haut du 
programme Applesoft (cette adresse est stock^e en $73/$74 et est 
appelee HIMEM) et le debut du DOS 3.3 en $9D00. 
ProDos 8, de son cote n'inialise pas de buffer fichier; il assigne ou de- 
assigne dynamiquement des buffers fichiers au moment oCi les fi- 
chiers sont ouverts et fermes. Quand un fichier est ouvert, ProDos 8 
diminue HIMEM de 1024 octets, et attribue ce buffer de 1024 octets k 
partir de la zone memoire commengant en HIMEM + 1024. Quand un 
fichier est ferme, les buffers fichiers sont repositionnes, et HIMEM est 
augmente de 1 024 octets. Un total de huit fichiers peu vent etre ouverts 
simultanement. Puisque ProDos utilise cette methode d' allocation 
dynamique pour les buffers fichiers, il n'est pas possible d'utiliser la 
technique qui en DOS 3.3 consiste k reserver un espace memoire pour 
y loger un programme machine en faisant diminuer HIMEM et en 
stocKant le programme machine dans la zone memoire ainsi liberee. 

5.0.4 Caracteristiques importantes de ProDos 8 et de BASIC.SYSTEM 

Un environnement PRODOS + BASIC.SYSTEM int^gre de nombreu- 
ses caracteristiques utiles qui ameliorent la vitesse a execution d'un 
programme et qui permettent de prendre en compte facilement des 
peripheriques non Apple dans le syst^me. Void quelques une de ces 
importantes caracteristiques. 

Interface Langage Machine (MLI) 

II est probable que la caracteristique la plus importante du ProDos 8 
est I'interpreteur de commande disque appele MLI (Machine Lan- 
guage Interface), qui permet un acc^s facile aux fichiers en utilisant les 
techniques de programmation du langage assembleur. Le DOS 3.3 ne 
dispose pas d'une telle interface et il est assez malcommode de 
programmer en langage assembleur dans son environnement. Avec 
les commandes MLI, on peut faire de la manipulation de fichiers 
comme ouvrir, lire, ecrire, et fermer un fichier. Les param^tres corres- 
pondants k chacune des commandes ont clairement ete definis par 
Apple. Nous examinerons plus tard les diverses commandes du MLI. 
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5.0.5 Datage des fichiers 

A chaque fois que ProDos 8 cree ou ecrit un fichier, il lit la date et 
I'heure courantes h partir de I'horloge installee dans le syst^me {k 
supDoser qu'il y en ait une), et range ces informations dans r entree du 
catalogue de ce fichier. Quand le disaue est catalogue, la date et 
I'heure de creation et la derni^re modification apparaissent apr^s le 
nom de ce fichier. ProDos 8 travaille avec I'horloge integre de iV^pple 
II GS et avec toutes les cartes horloge qui emulent le jeu de comman- 
des de la Thunderclock de Thunderware. 

5.0.6 Carte controleur de disque et protocoles pour les drivers 
de peripheriques 

Une des grandes contrainte du DOS 3.3 est qu'il est tr^s difficile de lui 
integrer et de lui faire reconnaitre des peripheriques disque autres 
que ceux developpes par Apple (Lecteurs de disquettes haute densite, 
Disques durs compatibles, etc ...). II n'en est pas de meme avec ProDos 
8. Apple a publie un protocole de communication reconnu par le 
ProDos 8 qui permet de faire reconnaitre au syst^me les peripheri- 
aues disque autres que ceux qu' Apple commercialise. Ce protocole 
definit les adresses de la ROM de la carte controleur faisant reference 
k la taille de ce volume, les caracteristiques de ce volume, et I'adresse 
de la sous routine du driver responsable des operations I/O de ce 
peripherique. Apple a egalement defini la technique pour passer ces 
param^tres h une sous routine driver disque ProDos 8 et comment le 
driver retourne des codes d'erreurs au programme appelant. 

5.0.7 Une gestion amelioree des Interruptions 

ProDos 8 installe automatiquement sa propre routine de gestion des 
interruptions qui prend le controle du syst^me k chaque fois qu'un 
peripherique I/O gen^re un signal IRQ (Interrupt Request): Cette 
sous routine peut alors appeler d'autres sous routines permettant de 
gerer ces interruptions. Cela signifie qu'il est assez facile d'integrer 
une sous routine d'interruption meme si une autre est dej^ active. 

5.0.8 Structure hierarchisee du catalogue 

En utilisant ProDos 8, il est possible de creer plusieurs catalogues, 
chacun d'entre eux pouvant contenir plusieurs fichiers, le tout sur le 
meme disque. Cela permet de ranger commodement dans un meme 
catalogue un groupe de fichiers ayant des points communs pour 
pouvoir y avoir acc^s plus facilement. Les catalogues sont organises 
de mani^re k ce que chacun d'entre eux soit contenu dans un autre (le 
catalogue p&re); le chemin d'acc^s des catalogues revient finalement 
au catalogue principal, la racine, que I'on appelle aussi le catalogue 
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Volume. Le catalogue principal est celui que Ton cr^ et que Ton 
nomme quand le disque est format^. Nous analyserons plus tard et en 
detail la struture hierarchisee des catalogues. 

5.0.9 Peripherique disque /RAM 

L' Apple II GS, r Apple lie, et 1' Apple He (dot^ d'une carte 80 colonnes 
^tendue) possMe une m^moire auxiliaire de 64 Ko en supplement des 
64 Ko de memoire principale utilise normalement pour le rangement 
des programmes. ProDos 8 utilise cet espace memoire pour le stoc- 
kage de fichiers de la m§me fagon qu'il le fait sur un lecteur de 
disquettes ou un disque dur. Ceci s appelle un Ram Disque. Les 
orincipales differences entre I'utilisation d'un Ram Disaue et un 
ecteur de disques conventionnel sont que les operations I/O se font 
jeaucoup plus rapidement (il nV aucune partie m^canique k d^pla- 
cer) et que le contenu du RAM Disque disparait d^s que I'alimenta- 
tion electrique de I'ordinateur est couple. Nous le verrons plus loin, 
mais il faut savoir que chaque volume disque du syst^me a un nom, 
il s'agit du nom de volume. Le nom de volume pour le RAM Disque 
est /RAM. 



5.0.10 Prolongement du BASIC.SYSTEM 

Le BASIC.SYSTEM offre une m^thode simple que vous pouvez 
utiliser pour lui ajouter des commandes additionnelles. 

5.0.11 Separation des p>ouvoirs 

Contrairement au DOS 3.3, 1'interpreteur de commandes bas niveau 
de ProDos 8, celui qui prend en charge toutes les operations disque 
I/O fondamentales n'est pas int^gre au sein de I'interpreteur 
BASIC.SYSTEM qui permet de communiquer avec un jeu oe com- 
mandes disque -en anglais" lorsque I'en programme en BASIC 
Applesoft. Cela signifie que si vous d^sirez ecrire un autre interpr^- 
teur de commandes, ou un programme 100% en langage assembleur, 
vous pouvez economiser environ 12 Ko de memoire en le chargeant 
k la place de BASIC.SYSTEM. 

5.0.12.1 La commande RUN intelligente 

La commande - du BASIC.SYSTEM est une commande tr^s pratique 
pour les gens qui n'aiment pas taper au clavier. EJle execute soit un 
programme Applesoft (comme le fait un RUN), soit un f ichier binaire 
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(BRUN), soit un fichier texte (EXEC) en determinant automatique- 
ment quel type de fichier a ^t6 sp^cifi^ puis en ex^utant le travail 
necessaire au lancement de ce fichier. Cette commande peut ^gale- 
ment executer des fichiers SYStem comme par exemple 
B ASIC.SYSTEM. En gros, un programme SYSt^me est un programme 
independant ecrit en langage assembleur, qui d^finit un environne- 
ment de programmation, ou un programme realisant des fonctions 
specifiques sans tenir compte de la presence d'un autre programme 

5.0.13 Des param^tres tr^s utiles 

Beaucoup des commandes du BASIC.SYSTEM supportent des para- 
m^tres tr^s utiles permettant un contrdle plus grand sur la mani^re 
dont elles sont executees. Par exemple, vous pouvez utiliser le suffixe 
# (oCi# represente un num^ro de ligne) avec la commande RUN du 
BASIC.SYSTEM pour charger un programme puis le lancer k partir de 
ce numero de ligne. Vous pouvez utiliser aussi le suffixe E# (oii# 
represente une adresse memoire) pour specifier une adresse de fin en 
utilisant une commande agissant sur un fichier BINaire (BLOAD et 
BSAVE). Vous pouvez aussi utiliser le suffixe Ttype avec BLOAD ou 
BSAVE pour travailler avec tous les types de fichiers autres que les 
fichiers BINaires. Le type de fichier est les trois caract^res qui suivent 
le nom d'un fichier : BAS pour BASIC, BIN pour BINaire, TXT pour 
TeXT, etc ... Un autre param^tre tr^s utile est F#; lors de la lecture d'un 
fichier texte son utilisation permet de sauter un nombre specific 
d'enregistrements (un enregistrement est un groupe de caract^res 
suivi par un <RETURN>. 

5.0.14 Vitesse 

ProDos 8 realise les operations disque I/O sur une disquette 5.25 h un 
debit d' environ 8 Ko par seconde. Cela est beaucoup plus rapide 
qu'en DOS 3.3 qui a un debit d'environ 1 Ko par seconde. De plus, 
BASIC.SYSTEM comprend une nouvelle version de la commande 
PRE qui permet de faire le menage parmi les variables chaines du 
BASIC Applesoft beaucoup plus rapidement que son Equivalent en 
DOS 3.3 (il faut plusieurs mmutes au DOS 3.3 pour faire ce travail 
alors qu'il ne faut que quelques secondes h ProDos 8 pour realiser le 
meme travail). 

5.0.15 Taille des fichiers et taille des volumes 

ProDos 8 peut g^rer des fichiers ayant une taille allant jusqu'^ 16 
Mega-octets, sur un volume pouvant avoir une taille jusqu'^ 32Mega- 
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octets. Les volumes EXDS 3.3 ne peuvent pas exc^der 400 Ko. 

5.0.16 Comparaison de GS / OS et de ProDos 8 

La difference fondamentale entre GS/OS et ProDos 8 est bien sur que 
GS/OS ne fonctionne que sur I'Apple II GS. Ceci parce que GS/OS est 
ecrit en langage assembleur 65C816, et qu'il utilise la Boite k outils 
(Toolbox) de 1 Apple II GS comme par exemple le Memory Manager 
et le System Loader. Quoique la plupart des commandes GS/OS ont 
un equivalent sous ProDos 8, quelques commandes uniques font de 
GS/OS un environnement de programmation beaucoup plus riche. 

1- Une application sous GS/OS peut appeler toutes les commandes 
GS/OS de n'importe quelle adresse memoire k I'interieur des 16 
Mega-octets adressables par le 6C816. Une application sous ProDos 8 
peut appeler les commandes ProDos 8 seulement h partir des pre- 
miers 64 Ko de memoire. 

2- Les applications sous GS/OS sont stockees dans des fichiers 
relogeables; cela signifie qu'elles peuvent etre chargees et executees 
k toute adresse memoire. Les applications ProDos 8 sont simplement 
des images binaires du code programme, et en general elles ne 

{)euvent etre executees qu'^ partir d^ne adresse memoire specifique. 
1 est bien entendu possible d'ecrire des applications sous ProDos 8 

r§l9g§afel§§; m§i§ g§1§ rend leur programmation particulilrgm§nt 

difficile et la plupart des programmeurs ne s'ennuient pas avec ce 
probl^me. 

3- Les applications sous GS/OS utilisent le Memory Manager de 
I'Apple II GS pour s'assurer qu'elles n'utilisent pas des zones de 
memoire dej^ utilisees par d'autres programmes ou fichiers ressour- 
ces du syst^me. Les applications sous ProDos 8 sont responsables de 
leur gestion memoire, les programmeurs doivent done veiller aux 
zones memoire utilisees par le ProDos 8. 

4- GS/OS a 33 prefixes de pathname qui peuvent etre references par 
un nom special abrege comme par exemple 1/ ou 28/. ProDos 8 
dispose seulement d un prefixe de pathname que Ton appelle le 
prefixe par defaut. 

5- GS/OS identifie les peripherigues disque par un nom alors que 
ProDos 8 les identifie par un numero de connecteur (slot) et de lecteur 
(drive). 

6- GS/OS dispose d'une commande integree pour formater les dis- 
ques (Format) et d'une commande permettant de cataloguer un 
volume (GetDirEntry). ProDos 8 ne dispose pas de ces commandes. 
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7- GS/OS a une commande permettant de d^placer des fichiers d'un 
catalogue k un autre (ChangePath). ProDos 8 ne dispose pas de cette 
commande. 

8- Sous GS/OS, une application peut determiner son propre nom avec 
la commande GetName. ProDos 8 ne dispose pas de commande 
similaire; une application peut d^duire son nom en inspectant le 
buffer pathname. 

9- GS/OS dispose d'une commande Quit amelioree qu'une applica- 
tion peut utiliser pour directement passer le controle au programme 
SYSteme qui I'a appelee, ou passer le controle k tout programme 
syst&me presaue comme s'il s'agissait d'une sous-routine. La com- 
mande Quit ae ProDos 8 peut seulement passer le controle k un 
selecteur de programmes. 

10- GS/OS peut creer et gerer des fichiers etendus, ProDos 8 ne le peut 
pas. Les fichiers etendus (parfois appeles fichiers ressource) sont 
constitues de deux parties logiques : une partie donnees et une partie 
ressource. La partie data contient generalement les donnees specifi- 

aues k I'application, la partie ressource contient en general un groupe 
e donnees que Ton appelle ressources qui peuvent etre des choses 
comme des icones, des chaines de caract^res, les messages d'erreurs, 
etc ... 

11- GS/OS utilise des FST (File System Translator) pour permettre 
aux applications I'acc^s k des volumes disque n'utilisant pas le 
syst^me d' exploitation ProDos, comme par exemple le syst^me High 
Sierra pour le CD Rom ou le syst^me HFS pour le Macintosh. GS/OS 
utilise aussi un FST pour acceder aux fichiers de type ProDos. Le 
ProDos 8 fonctionne uniquement avec des disques formates sous 
ProDos. 

12- GS/OS permet k une application d'avoir acc^s k des peripheriques 
orientes caract^res comme par exemple I'ecran video, le clavier, le 
modem, et I'imprimante en utilisant le meme type de commandes que 
pour acceder aux fichiers disque. Sous ProDos 8, I'application doit 
utiliser des techniques tout k fait differentes pour acc^er aux peri- 
pheriques orientes caract^res, chacun d'eux necessitant la compre- 
hension du fonctionnement du hardware en detail. 

13- GS/OS accede aux disques plus rapidement que ProDos 8 car il 
utilise des techniques de disque cache et un codage assembleur 
65C816 optimise. Ilpeut aussi formater les disques avec un entrelace- 
ment de pistes plus bas (2:1 k la place de 4:1), am^liorant ainsi la 
Vitesse de transfert des donnees. 
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14- GS/OS permet d'ouvrir un nombre illimit^ de fichiers et de 
volumes; il n' impose pas de limites sur le nombre de peripheriques 
par slot. ProDos 8 autorise seulement 8 fichiers ouverts simultan4- 
ment, 14 volumes actifs, et deux peripheriques par slots. 

15- GS/OS utilisant des FST peut acc6der k des volumes rion ProDos 
pouvant avoir une taille jusqu'^ 2048 GO (Giga-Octets), et peut g^rer 
des fichiers ayantiusqu'^ une longueur de4096 M^ga-octets. La taille 
des volumes ProDos ne peut pas exc^der 32 M^ga-octets, les fichiers 
ne peuvent pas depasser 16 M^ga-octets. 

16- GS/OS n'est pas fourni avec un langage BASIC interpret^ comme 
BASIC.SYSTEM sous ProDos 8. 
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5.1 Volumes disques et organisation des fichiers 

Dans cette partie, nous allons nous familiariser avec le concept de 
fichier et expliquer comment le syst^me ProDos organise les ficniers 
sur la surface du disque. II est n^cessaire de connaitre les details de ce 
syst^me si vous voulez comprendre parfaitement le fonctionnement 
des commandes agissant sur les fichiers. GS/OS peut travailler avec 
des syst^mes d'exploitation compl^tement diffeents du ProDos, 
mais la plupart des utilisateurs utilisent GS/OS avec des disques 
format^ sous ProDos. 

Le concept de fichier est commun et fondamental h tous les syst^mes 
d'exploitation. Un fichier est tout simplement un ensemble de don- 
nas qui peut §tre un programme executable, une lettre k votre 
editeur, une feuille de calcul pour un tableur, ou tout autre document 
au'un programme peut g^rer. La structure g^n^rale d'un fichier est 
d^finie par le syst^me d'exploitation lui m^me; le syst^me d'exploi- 
tation fournit egalement les diverses commandes n^cessaires pour 
acc^der aux fichiers : creation, ouverture, lecture, Venture, fermeture, 
destruction, etc ... 

5.1.1 Donner un nom aux fichiers 

Lorsque vous sau vez pour la premiere fois un fichier sur disque, vous 
devez lui donner un nom qu'un programme pourra identifier par la 
suite. Un nom de fichier ProDos peut §tre constitu^ d'un maximum 
de 15 caract^res. II doit commencer par une lettre alphab^tique (A k 
Z), mais les autres caract^res peuvent §tre toute combinaison de 
lettres, de chiffres (0 k 9), et de jx)ints (.). Vous pou vez aussi utiliser les 
lerttres minuscules, mais ProDos 8 et GS/OS les convertissent imm6- 
diatement en majuscules. Void quelques exemples de nom de fichiers 
accept^ par ProDos : 



MODELE.LETTRE 

CONTRAT.3 CHAPITRE.QUATRE 
Void quelques exemples de noms de fichiers non valides : 

5.MORCEAUX Commence par un nombre 

CHIEN ROUGE Contient un espace 

CECI&CELA Contient un& 

LE.DANUBE.DE.LA.PENSEE Trop long 
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Une erreur souvent commise est I'utilisation de I'espace comme s^pa- 
rateur de mots (voir exemple 2 ci dessus). Cela est permis en DOS 3.3 
mais pas en ProDos. Les points (.) et non les espaces doivent §tre 
utilises pour separer les mots dans un nom de fichier pour am^liorer 
la lisibilite. Certains programmes, comme Appleworks, permettent k 
I'utilisateur d'entrer des espaces dans le nom des fichiers, mais ils 
convertissent automatiquement les espaces enpoints avant d'utiliser 
les commandes du syst^me d' exploitation. GS/OS peut travailler 
avec des volumes disque qui ont 6t6 formates avec d'autres syst^mes 
d' exploitation, si le FST approprie se trouve sur le disque systeme. Les 
regies pour nommer les nchiers sont differentes pour ces syst^mes 
d'exploitation. Par exemple, le systeme HFS du Macintosh permet de 
donner des noms d'une longueur maximum de 31 caract^res: ces non 
peuvent contenir tout caract^re ASCII imprimable sauf les deux 
points (:). Consultez les manuels de reference du systeme d'exploita- 
tion utilise pour connaitre les regies en ce qui conceme les noms de 
fichiers. 

5.1.2 Catalogues et Sous-Catalogues 

Quand vous sauvegardez un fichier ProDos sur disque, vous pouvez 
le ranger dans n'importe lequel des catalogues qui a pu §tre cree sur 
ce disque. Ces catalogues sont similaires h des dossiers dans lesguels 
on peut classer des nches, car on place dans des dossiers des fiches 
ayant un lien entre elles. En fait le terme dossier est employ^ en inf or- 
matique comme un synonyme de catalogue, on emploie aussi le terme 
repertoire. Par exemple, il est possible de cr^r un catalogue pour y 
stocker tous les documents traitement de textes, et un autre catalogue 
pour y placer tous les programmes Applesoft. La possibility de cr^r 
des catalogues separ^s sur le mSme disque facilitel' organisation et le 
rangement d'un nombre important de fichiers. 

Quand on formate un disque, seul un catalogue, le catalogue princi- 
pal du volume, existe. On lui donne un nom lorsque Ton formate le 
disque. II devient alors le nom de ce volume. Les regies pour nommer 
les catalogues sont identiques k celles qu'il faut observer pour nom- 
mer un fichier. Le catalogue principal d'un volume formate k I'aide de 
ProDos peut contenir le nom d'un maximum de 51 fichiers. Le DOS 
3.3 accepte 105 noms de fichiers. 

II est possible de creer des catalogues supplementaires (on les appelle 
alors des sous-catalogues) k partir du catalogue principal en utilisant 
la commande CREATE de GS/OS ou de ProDos. On peut m§me cr^r 
des sous-catalogues k I'interieur d'autres sous-catalogues. Un sous- 
catalogue peut contenir les noms d'autant de fichiers aue vous 
desirez, iusqu'^ ce que votre disque soit plein. Ce systeme ae catalo- 
gues imoriques s' appelle une structure de catalogues hi^rarchis^. 

272 copyright Toolbox 1990 



Tous les syst^mes d'exploitation modemes utilisent une structure de 
catalogue hi^rarchis^. 

Pour indiquer le catalogue oh un fichier doit §tre sauv6, vous devez 
ajouter h son nom unpr^fixe sp^al afin de cr^r un identificateur 
unique appel^ le PATHNAME ou Chemin d'Acc^s en frangais. Un 
Pathname est constitue des noms d'une s^rie de catalogues commen- 
gant par le nom du catalogue principal et continuant a vec les noms de 
tous les catalogues par lesquels il faut passer pour atteindre le 
catalogue final, suivie par le nom du fichier lui meme. Chaque nom 
de catalogue est separe du pr^c^dent par un d^limitateur sp^al, et 
ce delimitateur doit pr^^e le nom du catalogue principal. 
Sous GS /OS, ce caract^re delimitateur peut §tre soit le slash ( / ) ou les 
deux points (:). Sous ProDos 8, cela doit etre un slash (/). Nous 
utiliserons le / comme delimitateur dans les explications k venir. 

Les noms de catalogues dans un Pathname (chemin d'acc^s) doivent 
definir un chemin continu; cela signifie que chaque catalogue sp^cifi^ 
doit etre contenu dans le catalogue precedent. Par exemple, supposez 

aue nous ayons un disque appele APPLE; le catalogue principal de ce 
isque a done le nom de APPLE. Supposez que le volume APPLE ait 
deux sous-catalogues appel^s APPLE.2 et MAC. 

Le tableau suivant montre cette structure de catalogues. 
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CATALOGUE PRINCIPAL 



/APPLE/ H4>/APPLE/APPLE.2 



PRODOS SYS 

BASIC.SYSTEM SYS 

STARTUP BAS 

APPLE.2 DIR 

MAC DIR 



APPLE.2E 
APPLE.2C 
APPLE.2GS 



TXT 
TXT 
DIR 



cj> APPLE/MAC c4> APPLE/APPLE.2/APPLE.2GS 



MAC.PLUS TXT 

MAC.SE TXT 

MAC.2 DIR 



ROM.01 
ROM.02 



TXT 
TXT 



Li4> /APPLE/MAC/MAC2 



GOGOl TXT 
G0G02 TXT 



Si vous voulez sauvegarder un fichier appeI6 MAC.PLUS dans le 
sous-catalogue MAC, vous devrez indiquer le Pathname suivant : 

/APPLE/MAC/MACPLUS 

Si vous aviez seulement indiqu^ le nom de fichier MAC.PLUS, ce 
fichier aurait 4t^ sauvegard^ dans le catalogue courant, qui est en 
g^n^ral le catalogue principal k moins que le catalog;ue courant ait 6t6 
change avec la commande SetPrefix que nous d^cnrons plus loin. 

Sous GS/OS vous pouvez sp^fier un nom de p6riph6rique, h la place 
d'un nom de volume (le nom du volume est le meme que le nom de 
catalogue principal), au moment oil Ton forme le pathname. Les noms 
de p^ripheriques commencent par un point (.) et peuvent avoir un 
nombre de caract^res compns entre 2 et 31. .SCSIl, .DEV4, 
. APPLEDISK3.5A sont des exemples de noms de p6riph6riques. Si le 
fichier MAC.PLUS de I'exemple pr&6ient se trouve sur le p^riph^ri- 
que appel6 .SCSIl; on pourrait I'ldentifier avec le pathname suivant : 

.SCSIl /MAC/MACPLUS 
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Cette techniaue ne peut pas ^tre utilise sous ProDos 8 car ProDos 8 
n' utilise pas les noms de p^riph^riques. 

Comme indiqu^ plus haut, sous GS/OS, le d^limitateur dans un Path- 
name peut etre / ou : mais vous ne pouvezpas utiliser deux d^limi- 
tateurs diff^rents pour un seul pathname. GS/OS determine le d^li- 
mitateur en examinant le Patnname indiqu^ de gauche h droite 
jusgu'i ce qu'il trouve un / ou un :; le caract^re trouv6 servira de 
d^limitateur. 

Si le delimitateur (sous GS/OS) est : vous pouvez utiliser des / dans 
les noms de fichiers, ce qui est tr^ important si vous d^irez acc^der 
k des fichiers ne se trouvant pas sur un volume ProDos (en utilisant un 
FST approprie). Par exemple, les fichiers Macintosh peu vent contenir 
des / . L'inverse n'est pas possible. En effet, si le d^imitateur est un 
/, vous ne pouvez pas utiliser : dans un nom de fichier. II estpr^f^rable 
dans une application sous GS/OS d'utiliser le : comme d^imitateur 
dans les Pathnames. 

5.1.3 Les Prefixes 

Si la plupart des fichiers que vous allez utiliser se trouvent dans le 
meme sous-catalogue, il devient rapidement ennuyeux de spi^dfier le 
m^me Pathname (chemin d'acc^J de catalogues h chaque fois que 
Ton veut acc^der k I'un de ces fichiers. Pour supprimer ce probl^me, 
GS/OS et ProDos 8 ont une commande SetPrenx que vous pouvez 
utiliser p>our former une chaine de noms de catalogues qui s'ajoutera 
automatiquement k tout nom de fichier que vous spicifierez dans une 
commande. Cette chaine s'appelle le Prefixe par d^faut et ne peut pas 
avoir une longueur sup^rieure k 64 caract^res sous ProDos 8 ou cfe 8 
Ko sous GS/OS. Si par exemple vous fixez le prefixe par d^faut sur 
/APPLE/MAC/, vous pouvez faire r^f^rence k tout fichier de ce 
sous-catalogue en lui ajoutant simplement le nom de ce fichier (par 
exemple MAC.PLUS). Un nom qui est la continuation du prefixe par 
d^faut peut aussi aco^der k des niveaux de sous-catalogues plus bas; 
un tel nom s'appelle un Pathname partiel. Si, par exemple, le pr^fbce 
par d^faut est /APPLE/MAC/, et si le sous-catalogue MAC contient 
un sous-catalogue appel6 MAC.2 contenant lui meme un fichier 
app)el^ GOGOf, vous pouvez acc^er k ce fichier en accolant au 
Pathname /APPLE/MAC/ le Pathname partiel MAC.2/G0G01. Le 
Pathname partiel n'est pas pr6c6d6 par un /. 
Sous GS/OS (mais pas sous ft-oDos 8), on peut utiliser une forme 
raccourcie du Prefixe par d^faut en le rempla(jant par 0/. Dans notre 
exemple, cela simifiequeO/ est Equivalents /APPLE /MAC. Comme 
le montre le tableau suivant, GS/OS reconnait 32 prefixes diff^rents 
avixquels on peut faire r^f^rence par un nombre suivi de /(de 0/k 31 / 
). GS/OS reconnait aussi le prefixe de boot (le nom du volume k partir 
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duquel vous avez boote) en Tidentifiant par */; on ne peut pas 
modifier */ A/ ei9/ identifient le catalogue dans lequel I'appli cation 
courante reside. 2/ identifie le catalogue qui contient les fichiers 
syst^me. On peut modifier 1/, 2/, et 9/ avec la commande GS/OS 
SetPrefix. Vous pouvez utiliser les autres prefixes cjuand une applica- 
tion a besoin d'identifier un catalogue particulier en utilisant les 
prefixes abreges de GS/OS. 

Sous ProDos 8 les prefixes peuvent, au maximum, avoir une longueur 
de 64 caract^res, en comptant le / qui doit les pr^c6der. Les Pathnames 
partiels ne peuvent eux non plus d^passer 64 caract^res. GS/OS a 
deux sortes de prefixes : les courts et les longs. Les prefixes courts (*/ 
, et 0/ ^ 7/ ) peuvent avoir au maximum une longueur de 64 caract^res; 
les prefixes longs (8/^31/) peuvent avoir au maximum une longueur 
de §192 caract^res. 



LES NUMEROS DE PREFIXE SOUS GS/OS 



Numero 
de PREHXE 



DESCRIPTION 



V 
0/ 
1/ 
2/ 
3/4 8/ 

9/ 
10/ k /31 



LE PREHXE DE BOOT. C'EST LE NOM DU VOLUME DE BOOT. 

LE PREHXE PAR DEFAUT. AUTOMATIQUEMENT AJOUTE. 

LE PREFIXE OU EST LOCALISEE L'APPLICATION. 

LE PREHXE QUI POINTE SUR LA BIBLIOTHEQUE SYSTEME. 

LAISSES AU CHOIX DE L'UTILISATEUR. 

IDENTIQUEAl/. 

LAISSES AU CHOIX DE L'UTILISATEUR. 



Une caracteristique int^ressante de GS/OS et de ProDos 8 est qu'k 
chaque fois qu'une commande doit localiser un fichier d^crit par un 
Pathname, elle efi^ectue cette recherche sur tous les volumes disques 
connect^s au syst^me. Ceci est tout h. fait different du DOS 3.3 ou Von 
doit expliciter le numero de slot et de lecteur pour acc^der ^ un fichier 
(en utilisant les param^tres ,S# et ,D#). Pour des raisons de compati- 
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bilite avec le EXDS 3.3, on peut aussi utiliser ces param^tres avec le 
BASIC.SYSTEM. De toute fagon, BASIC.SYSTEM utilisera automati- 
quement le nom du volume disque indiqu^ par les param^tres de 
numero de slot et de lecteur pour creer le Pathname. 

Les avantages apport^s dans I'utilisation des sous-catalogues sont 
souventpeu evidents aux utilisateurs de lecteurs de disquettes, mais 
tout k fait clairs aux utilisateurs de disques durs. Sur un disque dur, 
on peut ranger des centaines de fichiers. Si tous les fichiers 4taient 
places dans un catalogue unique, il faudrait attendre un temps 
important pour localiser un fichier en parti culier lors du catalogue, de 
plus il y a de fortes chances pour que vous ne le trouviez pas parmi 
tous les autres fichiers. Heureusement que ProDos permet une orga- 
nisation hierarchisee des catalogues permettant ainsi de ranger les 
fichiers de meme interet dans un m§me sous-catalogue pour y acc^ 
der plus facilement. 

5.1.4 Les concepts fondamentaux pour la manipulation d'un fichier 

GS/OS et ProDos 8 disposent d'un interpr^teur de commandes qui 
peut comprendre une vari^t^ de commandes permettant de manipu- 
ler un ficnier. 



OPEN Ouverture d'un fichier pour les operations I/O. 

READ Lire des donnas h partir d'un fichier. 

Write Ecrire des donnees dans un fichier. 

Close Fermeture d'un fichier pour les operations I/O. 

Quatre commandes similaires sont ^galement disponibles sous 
Applesoft quand on utilise Tinterpr^teur BASIC.SYSTEM dans I'en- 
vironnement ProDos 8. 

5.1.5 Ouverture d'un fichier 

Avant d'utiliser un fichier, on doit I'ouvrir. On realise cette action en 
utilisant la commande Open suivie du nom du fichier que I'on desire 
ouvrir. Le syst^me d'exploitation ouvre un fichier d'abord en le 
localisant sur le volume disque, puis en lui attribuant un buffer 
special en memoire. Une partie de ce buffer contient I'information qui 
indique au syst^me d'exploitation k quel endroit du volume disque 
sont localisees les donnees de ce fichier; une autre partie de ce buffer 
contient la portion du fichier k lac^uelle on vient d'acceder. A chaque 
fois que Ton demande une operation I/O pour un fichier, le systfeme 
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d'exploitation d^ermine si la portion du fichier k laquelle on veut 
acc^der se fa-ouve dans ce buffer. Si c'est le cas, le syst^me d'exploita- 
tion n'a pas besoin d'acc^er k ce fichier sur le volume disque. Erange 
simplement les donn^es dans le buffer (dans le cas d'une operation 
d'^criture), ou lit les donn^es h partir de ce buffer (dans le cas d'une 
operation de lecture). Ainsi, les operations portant sur un fichier 
s exdcutent beaucoup plus rapidement que dans le cas oii on utilise- 
rait des techniques ne mettant pas en oeuvre de buffer en m^moire. 

ProDos 8 peut ouvrir un fichier k I'un des 16 diff^rents niveaux de 
fichiers syst^me (num^rot^ de ^ 15); GS/OS reconnait 256 niveaux 
diff^rents de fichiers syst^me (num^rot^s de ^ 255). Sous ProDos 8, 
une application peut sp^ifier un niveau de fichier syst^me en stoc- 
kant le numero ae niveau k une adresse m^moire particuli^re ($BF94) 
juste avant d'ouvrir le fichier. Sous GS/OS, I'application doit utiliser 
la commande SetLevel. Le fichier syst^me par d^faut a le niveau 0. 
L'avantage d' avoir diff^rents niveaux de fichiers permet d'^crire 
facilement des programmes "superviseurs". Ce type de programmes 
ouvrent leurs propres fichiers de travail, passent le contrdle k des 
programmes utilisateur, et reprennent le contrdle quand les pro- 
grammes utilisateur ont termini. Si un programme superviseur"a 
un niveau sup^rieur k un programme utilisateur, ses fichiers de 
travail ne pourront pas etre ferm^s par inadvertance par le pro- 
gramme utilisateur m§me si ce programme tente de fermer tous les 
fichiers ouverts. (sauf bien stir si le programme utilisateur ne respecte 
pas la procedure normale en d^crementant le niveau de fichier). 

5.1.6 Lecture et Ecriture d'un fichier 

Quand le syst^me d'exploitation ouvre un fichier, il initialise deux 
pointeurs internes importants qu'il utilise pour garder trace de la 
taille de ce fichier et de la demi^re position dans ce fichier r^f^renc^e 
par une application. Ces pointeurs sont appel^ EOF et MARK. 

1) MARK & EOF apr^ I'ouverture d'un fichier de 83 octets 



00 



82 83 



:^MARK 



t^EOF 
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2) MARK & EOF apres la lecture de 10 octets dans ce fichier 



00 10 



82 83 



95 



b^MARK 



cJ>EOF 



3) MARK ET EOF APRES L'ECRTTURE DE 12 OCTETS A LA FIN DU 
nCHIER. 



00 



82 83 



95 



MARK 
K> et 
EOF 



Note : EOF est automatiquement ^tendu. 

EOF (End Of File = Fin De Fichier) est le pointeur qui indique la fin du 
fichier; il pointe toujours un octet suppl^mentaire apr^s le dernier 
octet reel du fichier. Si vous tentez de faire une lecture de donnas 
dans ce fichier apr^s cet emplacement, une erreur se produira (I'er- 
reur "fin de donnas"). EOF se modifie seulement si une application 
6crit des donn^es h la fin de ce fichier; quand cela arrive, EOF est 
automatiquement incr^ment^ du nombre d'octets appropri^ et si 
n^cessaire, le syst^me d'exploitation attribue des blocks supplimen- 
taires sur le disque pour ce fichier. GS/OS et ProDos 8 disposent 
d une commande SetEOF permettant d'attribuer h EOF une vaieur 
speafique. 

MARK est un pointeur qui donne la position courante dans le firhier; 
il mdique toupurs la position k laquelle la prochaine op^raMon de 
lecture ou d Venture prendra place. II est 6gal k (le d^but du fichier) 
quand on ouvre un fichier pour la premiere fois, et il est automatique- 
ment mcr6ment6 k chaque fois que des donn^es sont lues et Rentes 
dans ce fichier. Par exemple, si MARK pointe sur 10 (c'est k dire sur 
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le 11 ^me octet du fichier), et que vous lisez ou ^crivez 14 octets 
suppl^mentaires d'information, MARK se positionnera alors k 24. 

II est aussi possible de donner une valeur explidte au pointeur MARK 
j>ermettant ainsi d'acc^der k toutes les positions dans un fichier. Cela 
signifie qu'il est possible d'acc^er k un enregistrement d'un fichier 
contenant des longueurs d'enregistrement fixes tr^s rapidement, car 
il n'est pas necessaire de lire tous les enregistrements prec^ents. 

5.1.7 Fermeture d'un fichier 

Une fois que Ton a termini de travailler avec un fichier, il faut le 
fermer. Cela permet de s' assurer que les donnas se trouvant dans le 
buffer fichier, et pas encore rangees sur disque, vont §tre sauvegar- 
dees sur le disque lui meme. La fermeture d'un fichier met 6galement 
k jour dans le catalogue la taille de ce fichier. 

II n'est pas necessaire de fermer un fichier imm^iatement apr^s avoir 
fini de travailler avec lui. On peut attendre jusqu'^ la fin du pro- 

framme pour proc^der k cette fermeture. II est quand m^me pr^fera- 
le de proceder k cette fermeture le plus rapidement possible pour 
reduire le risque de perte de donnees dans le cas d'un plantage du 
syst^me ou d une coupure electrique. Le fait de fermer les fichiers 
inactifs lib^re de la memoire. 

5.1.8 GS/OS et la technique du disque cache 

Pour accelerer les operations disque comme celles d^crites plus haut, 
GS/OS effectue un cache des blocs disque. Le cache disque est une 
zone de memoire oii GS/OS sauvegarde une copie des blocs disque 
quand il les a lu une fois k partir du disque. GS/OS place aussi dans 
ce cache des copies des blocks qu'il 6crit sur disque. Une fois qu'un 
bloc est dans le cache, GS/OS peut rapidement le r^cup^rer de la 
memoire k chaque fois qu'il a besoin de relire ce bloc disque. GS/OS 
n'a alors pas besoin de refaire un acc^ disque (relativement lent) 

Eour relire ce bloc, 
'utilisateur peut r^^ler la taille de ce cache disque avec I'accessoire 
de bureau (NDA) EMsk Cache. (Dans le syst^me 5.0 ce r^glage est 
incorpord dans le NDA plus g^n^ral Control Panel qui permet de 
configurer tout le syst^me.) Une applicationpeut r^gler la taille de ce 
cache en utilisant la commande GS/OS ResetCache apr^ avoir 
sauvegarde cette nouvelle taille du cache dans la Ram aliment^e 
(BRAM) en utilisant pour cela la fonction WriteBParam. Plus la taille 
du cache est importante, plus GS/OS est performant, mais I'espace 
memoire utilisaole par les applications s'en trouve r^duit en propor- 
tion. 
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Dans la plupart des cas, la taille du cache n' est pas suffisamment 
importante pour contenir tous les blocsque GS/OS voudrait y placer. 
Quand la memoire cache est satur^, GS/OS enl^ve de la memoire 
cache le bloc le moins r^cemment utilise pour lib^rer de la place au 
prochain bloc. 

Les commandes GS/OS Read et Write vous permettent de specifier 
des blocs disque specifiques qui pourront ou non etre places dans 
cette niemoire cache. 

5.1.9. Organisation des fichiers sous ProDos 

Les sy st^mes d'exploitation utilisent differentes methodes pour orga- 
niser les fichiers sur disque, et pour garder trace de auelles parties du 
disque ont ete utilis^es pour la sauvegarde des aonn^es, de telle 
mani^re que les fichiers peuvent f acilement et effica cement §tre cr64s, 
effaces, etc... Dans ce passage, nous allons examiner les points sui- 
vants : 



• La structure d'un volume disque format^ sous ProDos 

• La structure d'une bit map d'un volume ProDos 

• La structure des catalogues et des sous catalogues sous ProE>os 

• La structure d'une entree dans un catalogue ProDos 

• Le processus d'index utilise par ProDos pour localiser les fichiers 
ProDos utilise la meme methode gen^rale pour organiser les fichiers 
quel que soit le volume disque utilis6; il s'agit de toute fagon de 
volumes disque divises en blocs : lecteur Apple 5.25, lecteur Apple 
3.5, HD20SC, volume /RAM, etc ... Des differences sp^ciques peu- 
vent apparaitre car la capacite de stockage de ces diff^rents volumes 
est variable. De plus, les failles de deux structures tr^s importantes, le 
catalogue prinapal, et la bit map (table d'occupation) d'un volume 
peuvent §tre differentes. 

5.1.10 Formatage du volume disque 

Avant de pouvoir utiliser une disquette (ou tout autre support 
magnetique) avec GS/OS ou ProDos 8, elle doit §tre format^e pour 
que GS/OS ou ProDos 8 la reconnaisse. Vous pouvez formater un 
volume disque avec un Filer (ProSel, Copy II+, etc ...), ou avec les 
utilitaires syst^me qui se trouvent sur la disquette master ProDos 8, 
ou encore avec le Finder de GS/OS. GS/OS dispose d'une commande 
Format utilisable par les applications pour formater un volume 
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disque. 

La m^thode utilise pour formater un disque depend de la nature de 
ce periph^rique disque. Quand on formate une disquette 5.25, 35 
pistes sont crepes sur le disque (num^rot^es de el 34), cnacune d'entre 
eUes contenant 40% octets d' information. Ces pistes sont arrang^es 
en anneaux concentriques tout autour du trou central de la disquette; 
la piste se trouvant k I'ext^rieur, et la piste 34 k I'int^rieur. Le syst^me 
d'exploitation peut acc^er k chacune de ces pistes en d^la?ant une 
t§te de lecture Acriture sur la piste choisie. Ced est realise en utilisant 
des emplacements I/O particuliers qui activent un moteur pas k pas 
controlant le d^placement de la t§te de lecture /6criture. 

Chacune de ces 35 pistes est subdivis^e en 16 unites plus petites 
appel^es secteurs. Un secteur est la plus petite unit6 de donnees qui 
peut etre lue ou ^crite en meme temps. Les secteurs qui constituent 
une piste sont num^rot^s de k 15; chacun d'entre eux pouvant 
contenir 256 octets d'information. Si vous savez faire une multiplica- 
tion, vous vous apercevrez qu'une disquette 5.25 peut contenir 560 
secteurs d'information (140 Ko). , 

C'est la derni^re fois que vous entendrez parler de secteurs car 
ProDos utilise des blocs de 512 octets comme unit6 de base dans la 
manipulation des fichiers; chaque bloc est done constitu6 de deux 
secteurs. Une disquette 5.25 est done constitute de 280 de ces blocs 
(num^^rot^ de i 279). Heureusement, il est rarement n^cessaire de 
connaitre la localisation de ces blocs sur disque; le syst^me d'exploi- 
tation se charge de cette gestion. 

5.1.11 Volumes disque et Lecteurs de disque 

Une disquette format^ qui est en ligne (plac6e dans un lecteur et 

})rete k etre acc^^e) est souvent appel^e un volume disque. Les vo- 
umes ProDos ont des noms qui sui vent les memes regies de bapt^me 
que les fichiers, mais sont pr^^d^s d'un / pour les distinguer des 
noms de fichiers. 

Les lecteurs de disque eux-m§mes ont des identificateurs uniques. 
ProDos 8 donne un num^ro d'unit^ k chaque p^riph^rique disque 
connecte au syst^me. La valeur de ce num^ro d unit6 est torm^e par 
le num^ro de slot de la carte contrdleur de ce lecteur, et du num^ro du 
lecteur. 
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DR 


SLOT 


NON UTILISE 



SLOT peut en fait etre le num^ro r6el ou logique d'un slot si le syst^me 
contient des p^riph^riques disque comme par exemple un RAM 
disque. Par exemple, le num^ro d unit6 d'un volume /RAM cx)nnect6 
en slot 3, Drive 2 sur un He, lie, ou II GS est $B0 soit 1 Oil 0000. 

DR indique le num^ro de DRi ve (lecteur) : pour le lecteur 1 et 1 pour 
le lecteur 2. Plus de deux lecteurs peuvent etre connect^s au port 5 du 
SmartPort. Dans ce cas, ProDos 8 assigne logiquement les deux 
prochains lecteurs en Slot 2, Drive 1 et en Slot 2, Drive 2. ProDos 8 
Ignore tous les lecteurs connect^ au SmartPort apr^ le quatri^me. 

GS/OS donne des num^ros de r^f^rence uniaues aux p^riph^riques 
disque (et aux periph^riques caract^res) qu il trouve connecte au 
systeme. Ces nombres sont des entiers consmitif s commengant par 1 . 
If leur donne aussi un nom de p^riph6rique; par exemple 
.APPLEDISK3.5A, .SCSIl, etc ... ; ces noms peuvent §tre constitu^ de 
2 ^ 31 caract^res de long. GS/OS n'utilise pas le proc^d^ du num^ro 
d'unit^ utilise par ProDos 8. Voir plus loin pour des explications 
d^taill^es concernant les p^riph^riques disque et les conventions sur 
leur nom. 

5.1.12 Utilisation des blocs sur un Volume disque 

Nous allons maintenant examiner la m^thode utilise par ProDos 
pour g^rer les fichiers sur disque. Notre discussion inclu une analyse 
des structures des catalogues renfermant 1' information sur les fi- 
chiers, de la bit map qui renferme I'information concernant 1' utilisa- 
tion des blocs du volume disque, et des blocs d'index qui contiennent 
les emplacements des blocs de donn^es utilise par chacun des 
fichiers du volume. Comme nous I'avons dit plus haut, un total de 280 
blocs contenant 140 Ko de donn6es sont disponibles sur une disquette 
5.25 formatee sous ProDos. Si un programme standard de formatage 
est utilise, 7 de ces blocs (0 - 6) ne sont pas disponibles pour 1' utilisa- 
tion pour le stockage des fichiers car ProDos se les reserve. La figure 
suivante montre I'utilisation des blocs sur des disquettes 5.25 et 3.5 
venant d'etre format^es 



copyright TooflMW 1990 283 



BLOCN 



f 



* 



¥ 


BLOCS 


BLOC? 


BLOC 6 


BLOCS 


BLOC 4 


BLOC 3 


BLOC 2 


BLOCl 


BLOCO 





N=279 (DISQUE 5.25) 
N=1599 (DISQUE 3.50) 



CONTINUATION DE LA 
BIT MAP CHAQUE BLOC 
EST UTILISE POUR 2 MB 
DE DONNEES 



DEBUT DE LA BIT MAP 



CATALOGUE 
PRINCIPAL DU VOLUME 



BLOCS DE BOOT 
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Chaque bloc contient 512 octets. 

La capacite totale de stockage est de 280 blocs (140 Ko) pour un disk 5.25. 

La capacite totale de stockage est de 1600 blocs (800 Ko) pour un disk 3.50. 
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Les blocs et 1 contiennent un court programme en langage machine 
que le firmware de la carte contr61eur de disque charge en m^moire 
et execute h chaque fois qu'il boote un disque. Ce programme est 
appele programme de boot; il localise, charge et execute un fichier 
SVSt&me special appele ProDos s'il le trouve sur le disque. Un fichier 
SYSt^me a un type de fichier ayant pour code $FF, et le mn^monique 
SYS. PRODOS est le programme qui va installer et activer le syst^me 
d'exploitation. 

Les blocs 2^5 sont les blocs qui contiennent le catalogue principal du 
volume disque. Nous decrirons plus loin la structure de ce catalogue. 

Le bloc 6 est le premier bloc contenant la bit map pour un volume 
disque. Dans la bit map, chaque bit indique si le block auquel il 
correspond est libre ou occupe. ProDos reserve un bloc bit map pour 
chaque 2 MB (4096 blocs) d'espace de stockage. 

Les blocs au del^ du bloc de bit map (ou des blocs), soit un total de 273 
pour une disquette 5.25 ou 1593 pour une disquette 3.50, sont libres 
et peuvent etre utilises pour le stockage des fichiers sur disque. 

5.1.13 La bit map d'un volume (Table d'occupation) 

Le syst^me d'exploitation accede h la bit map d'un volume quand il 
a besoin de determiner I'etat de chaque bloc sur le disque. II lit la bit 
map k chaque fois qu'il attribue un nouvel espace disque k un fichier, 
de telle mani^re qu'il peut rapidement localiser les blocs libres de ce 
discjue. II ^crit dans la bit map pour reserver des blocs h un fichier; cela 
arrive quand un fichier d^j^ existant au^ente en taille, ou lib^re des 
blocs; cela arrive quand un fichier dimmue de taille ou quand il est 
effac^. 

Les routines standards de formatage utilisent le bloc 6 comme pre- 
mier bloc bit map d'un volume. Le bloc 6 est seulement un emplace- 
ment conventionnel pour placer le d^but de la bit map; il est possible 
de ranger la bit map n'importe oij ailleurs sur un bloc libre du disk. 
Par exemple, la bit map a'un volume /RAM est en bloc 3. Comme 
indiqu6 plus loin, le num^ro de bloc du premier bloc de bit map d'un 
volume apparait dans I'ent^te du catalogue principal d^crivant les 
caracteristiques du volume disque. 

Sur une disauette 5.25, seuls les 35 premiers octets (280 bits) du bloc 
de bit map au volume sont utilises; chacun des bits de chaque octet 
correspond k un num^ro unique de bloc. Un bloc de bit map peut done 
faire reference k des volumes constitues d'un maximum de 4096 
blocs. Pour des volumes plus importants, comme les disques durs, 
une continuation de la bit map peut etre trouvee sur les blocs suivants 
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directement celui utilise en premier. Par exemple, le vieux disque dur 
APPLE PROFILE (9728 blocs) n^essite 3 blocs pour constituer sa bit 
map. Le programme standard de formatage stocke la premiere partie 
de la bit map sur le bloc 6 et la continue sur les blocs 7 et 8. Le syst^me 
d'exploitation determine la taille de la bit map d'un volume en 
examinant deux octets dans I'ent^te du catalogue du volume indi- 
quant la taille de ce volume. 



NUMERO lyOCTET RELATIF DANS LE BLOC 



$00 
$08 



$10 
$18 



i> 



Numiro de bit 
4 3 2 







Numero de bloc 






1 


2 


3 


4 


5 


6 


7 



REPRESENTATION DE L'OCTET $00 



7 


6 


5 


Numiro de bit 
4 3 2 


1 





272 


273 


274 


275 


276 


277 


278 


279 1 



Numiro 
debloc 



REPRESENTATION DE L'OCTET $22 

CHAQUE OCTET DANS LA BIT MAP DU VOLUME DEFINIT L'ETAT DE HUIT 
BLOCS CONTIGUS. LE BIT CORRESPONDANT A UN NUMERO DE BLOC 
DONNE PEUT ETRE CALCULE EN DIVISANT D'ABORD LE NUMERO DE 
BLOC PAR 8; LA PARTIE ENTIERE DU RESULTAT DONNE LE NUMERO DE 
L'OCTET CORRESPONDANT. POUR OBTENIR LE NUMERO DU BIT DANS 
CET OCTET, OTEZ LE RESTE DE CETTE DIVISION DE 7. 
NUMERO UOCTET = INT ( NUMERO DE BLOC/ 8 ) 
NUMERO DE BIT = 7 - (( NUMERO DE BLOC ) - (8 • NUMERO D'OCTET )) 
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la figure ci-dessus montre la structure d'une bit map pour des dis- 
quettes 5.25. Comme vous pouvez le voir, les bits de cnacun des octets 
de cette bit map refldtent 1 etat de 8 blocs cons^cutifs; le bit corres- 
pond au bloc ayant le numero le plus haut, le bit 7correspond au bloc 
ayant le numero le plus bas. Si le bit correspondant k un bloc 
particulier est egal h 0, alors ce bloc est occup^. S il vaut 1, il est libre. 

Exemple de Bit Map 



00 00 3F FF FF FF FF FF FF FF FF FF FF 

OC FF FF FF FF FF FF FF FF FF FF FF FF 

18 FF FF FF FF FF FF FF FF FF FF FF 00 

24 00 00 00 00 00 00 00 00 00 00 00 00 

30 00 00 00 00 00 00 00 00 00 00 00 00 

3C 00 00 00 00 00 00 00 00 00 00 00 00 



Le premiere entree dans la table (octet $00) a pour valeur $00 ce qui 
correspond h 0000 0000 en binaire; cela signif ie que les blocs $00 h $07 
sont occupes. La deuxidme entree dans la table (octet $01) a pour 
valeur $3F ce qui correspond h 0011 1111 en binaire; cela signif ie que 
les blocs $08 h $09 sont occupes (valeur binaire 0), et que les dIocs $0A 
h $0F sont libres (valeur binaire 1). Les autres blocs de la bit map ($10 
^$117) sont libres car leur valeur binaire est 1 . Dans cet exemple nous 
avons done un total de dix blocs occupes sur le volume disque. Id la 
bit map s'arrete h partir de I'octet $23; le syst&me d' exploitation 
connait la taille de la bit map car il la retrouve dans I'entete du 
catalogue principal. 

5.1.14 Catalogues et Sous-Catalogues d'un Volume 

Un catalogue est un enchevetrement complique de donnees que Pro- 
Dos utilise pour conserver les informations importantes concernant 
chaque fichier sauvegarde sur le volume. Cela comprend le nom du 
fichier, son type, sa taille, sa date de creation, I'emplacement sur le 
volume des donnas de ce fichier, etc ... Sans ces informations, il ne 
serait pas possible de gerer efficacement de nombreux f ichiers sur un 
volume. 

Comme nous 1' avons dit, ProDos permet de creer de multiples cata- 
logues sur un volume. A 1' exception du catalogue principal (on 
accede h tous les autres catalogues en faisant reference au catalogue 
princij^al), ces catalogues peuvent occuper sur le volume tout 1 es- 
pace necessaire car ProDos les traite comme des f ichiers standards. Le 
catalogue principal debute toujours k partir du bloc 2; si vous utilisez 
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un programme de formatage standard, ou les commandes Format de 
GS/OS et EraseDisk, le catalogue principal occupera aussi les blocs 3, 
4et5. 

Un catalogue ProDos est un exemple d'une structure de donn^es h 
double lien. Les liens sont en fait des paires de pointeurs sur 2 octets 
stockes au debut de chaque bloc de catalogue. Un de ces pointeurs 
(Octets $00-$01) contient le num^ro du bloc de catalogue pr6c6dent 
dans la chaine, ou z^ro s'il n'y a pas de bloc precedent. Uautre 
pointeur (Octet $02-$03) contient le numero du prochain bloc catalo- 
gue, ou zero s'il n'y a pas de bloc catalogue k la suite. Cette technique 
permet de cr4er des catalogues de toute taille. 

Chaque bloc utilise par un catalogue peut contenir 13 entries de 
fichier; chaque entree de fichier est constitu^ de 39 octets. Cela 
signifie que le catalogue principal (blocs $02-$05) peut contenir un 
total de 52 entrees, dont I'une est I'entrte pour le nom de Volume lui 
meme. Voilk pourquoi vous obtenez parfois le sympathique message 
d'erreur "Disque Plein" alors que votre disque dur de 100 MO ne 
contient qu'une poignee de fichiers; vous avez simplement oubli^ de 
sauvegarder vos precieuses donn6es ailleurs que dans le catalogue 
principal qui ne peut contenir que 51 entr^s ... 
Quand ProDos doit trouver un fichier particulier, il lit en premier le 
bloc 2 du volume; il s'agit du bloc cle du volume, celui auquel le 
sy st^me d'exploitation accede le plus souvent (en consequence le plus 
fragile). Si ce fichier n'est pas trouv^ dans ce bloc, le bloc de catalogue 
suivant est lu, et ainsi de suite jusqu'au bloc 5. 
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5.1.14 Le Catalogue Principal d'un Volume ProDos 



— > PAS DE BLOC CATALCX^UE PRECEDENT 



BLOC 2 




"■" 




B 


LOC3 




— 




B 


LOC4 




— — 




B 


LOC5 




" 




— >PASD 


E SUITE 



ENTETE DU CATALOGUE 

LES 12 PREMIERS NOMS DE FICHIERS 

(BAS, BIN, SYS, ...) 



13 NOMS DE FICHIERS POSSIBLES 



13 NOMS DE FICHIERS POSSIBLES 



13 NOMS DE FICHIERS POSSIBLES 



AU TOTAL 51 ENTREES DE FICHIERS POSSIBLES 
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STRUCTURE VUN BLOC CATALOGUE 



N 

lyOCTET 

DANSLEBLCX: 

CATALOGUE 



SIGNinCATION 



$0(X)-$001 



$002-$003 



$004-$02A 



$02B-$051 

$052-$078 

$079-$09F 

$0A0-$0C6 

$0C7-$0ED 

$0EE-$114 

$115-$13B 

$13C-$162 

$163-$189 

$18A-$1B0 

$1B1-$1D7 

$1D8-$1FE 

$1FF 



NUMERO DE BLOC DU BLOC CATALOGUE PRECE- 
DENT (OCTET DE POIDS FAIBLE EN PREMIER) 
EGAL k STL S'AGIT DU PREMIER BLOC CATALOGUE 

NUMERO DE BLOC DU BLOC CATALOGUE SUIVANT 
(OCTET DE POIDS FAIBLE EN PREMIER) EGAL k STL 
S'AGIT DU DERNIER BLOC CATALOGUE 

ENTREE AU CATALOGUE DU FICHIER NUMERO 1 OU, 
STL S'AGIT DU PREMIER BLOC CATALOGUE (BLOC 
CLE),LES OCTETS $00 ET $01 SONT EGALS ^ ET ON 
TROUVE ICI L'ENTETE DU CATALOGUE 
(DIRECTORY HEADER) 

ENTREE AU CATALOGUE DU HCHIER NUMERO 2 

ENTREE AU CATALOGUE DU HCHIER NUMERO 3 

ENTREE AU CATALOGUE DU HCHIER NUMERO 4 

ENTREE AU CATALOGUE DU HCHIER NUMERO 5 

ENTREE AU CATALOGUE DU HCHIER NUMERO 6 

ENTREE AU CATALOGUE DU HCHIER NUMERO 7 

ENTREE AU CATALOGUE DU HCHIER NUMERO 8 

ENTREE AU CATALOGUE DU HCHIER NUMERO 9 

ENTREE AU CATALOGUE DU HCHIER NUMERO 10 

ENTREE AU CATALOGUE DU HCHIER NUMERO 11 

ENTREE AU CATALOGUE DU HCHIER NUMERO 12 

ENTREE AU CATALOGUE DU HCHIER NUMERO 13 

NON UTILISE 
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5.1.15 L'Entete du Catalogue (Directory Header) 

Le premier bloc qu'un catalogue (ou qu'un sous-catalogue) utilise est 
le bloc cle, et il a une structure un peu differente des autres blocs 
catalogue. La difference reside dans les premiers 39 octets qui norma- 
lement decrivent Ten tree au catalogue du fichier numero 1; dans ce 
cas ces octets servent k decrirent le catalogue lui meme; cette entr^ 
est alors appelee entete du catalogue. Le tableau qui suit montre la 
signification de ces 39 octets constituant I'ent^te du catalogue. 



ENTETE D'UN CATALOGUE 



Numero de 
rOctet dans 
le Bloc Cle 



SIGNinCATION 



$04 



$05-$13 

$14-$1B 

$1C-1D 

$1E-$1F 

$20 
$21 

$22 



4 BITS PD FORT: TYPE D'ENREGISTREMENT 
$F = CATALOGUE VOLUME 
$E = SOUS CATALOGUE 

4 BITS PD FAIBLE: LONGUEUR DU NOM DU VOLUME 
IL SE TROUVE DANS LE CHAMP SUIVANT 

NOM DU VOLUME: 15 OCTETS (ASCII POSITIF) 
LA LONGUEUR DE CE NOM EST DANS L'OCTET $04 
LE RESTE DE CET ENREGISTREMENT EST IGNORE 
/ N'EST PAS UTIUSE ICI 

RESERVE POUR UNE UTILISATION FUTURE 
EN GENERAL REMPLI AVEC DES GO 

DATE DE CREATION DU CATALOGUE (FORMATAGE) 

YYYYYYYMMMMDDDD (Y=ANNEE, M=MOIS, D=JOUR) 

FORME BINAIRE 

MINUTE ET HEURE DE CREATION DU CATALOGUE 

O0OHHHHH0OMMMMMM(H=HEURE, 

M=MINUTE) FORME BINAIRE 

VERSION DE PRODOS QUI A FORMATE LE VOLUME 

VERSION MINIMUM DE PRODOS POUVANT UTILISER 
CE VOLUME 

CODE D'ACCES PRODOS (VOIR PLUS LOIN) 

$80 LE VOLUME PEUTETRE REFORMATS 
$40 LE VOLUME PEUTETRERENOMME 

$20 LE CATALOGUE A ETE MODIHE DEPUIS LE DER- 
NIER BACKUP 
$02 AUTORISATIOND'ECRITURESURLE VOLUME 
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$23 



$24 



$25-$26 



$27-$28 



$29-$2A 



$01 AUTORISATION DE LECTURE SUR LE VOLUME 

LE NOMBRE D'OCTETS UTILISES PAR CHAQUE ENTREE 
AU CATALOGUE ($27) 

LE NOMBRE EXENTREE SUR CHAQUE BLOC DE CATALO- 
GUE ($OD).L'ENTETE DU CATALOGUE EST CONSIDERE 
COMME UNE ENTREE 

NOMBRE D'ENTREES ACTIVES DANS LE CATALOGUE 
SANS COMPTER L'ENTETEDU CATALOGUE. 
UNE ENTREE ACTIVE DECRIT UN HCHIER OU UN SOUS 
CATALOGUE NON EFFACE. 

POINTEUR SUR LE PREMIER BLOC CONTENANT LA BIT 
MAP (EN GENERAL LE BLOC 6) DANS UN SOUS- 
CATALOGUE C'EST LE POINTEUR INDIQUANT LE 
BLOC DEFINISSANT L'ENTREE DE CE SOUS-CATALOGUE 

TAILLE EN BLOCS DU VOLUME ($01 18) POUR UN DISK 
5.25 (280) 



5.1.15 Entree au Catalogue 

Toutes les entrees au catalogue, autres que I'entete du Catalogue, 
representent soit des fichiers de donnees standards (binaires, texte, 
programme Basic Applesoft, etc.), soit des sous-catalogues. Les 
formats de ces differentes entr^s sont dans I'essentiel identiques et 
sont decrits ici. 
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DESCRIPTIF D'UNE ENTREE D'UN FICHIER AU CATALOGUE 

Numero 
Relatifde 
L'OCTETdans 
L'Enregistrement SIGNIHCATION 



$00 


4 BITS DE PD FORT: TYPE lyENREGISTREMENT 




$0 = 


ENTREE EFFACEE - ENTREE RE-DISPONIBLE 




$1 = 


FICHIER "SEEDLING" (1 SEUL BLOC DE DATA) 




$2 = 


nCHIER "SAPLING" (2 k 256 BLOCS DATA) 




$3 = 


nCHIER "TREE" (257 k 32768 BLOCS DATA) 




$4 = 


ZONE PASCAL 




$5 = 


nCHIERETENDU 




$D = 


SOUS-CATAL(X;UE 




$E = 


RESERVE POUR L'ENTREE D'UN SOUS-CATALOGUE 




$F = 


RESERVE POUR L'EN IE TE DU CATALOGUE PRINC. 




4 BITS DE PD FAIBLE: LONG. DU NOM DE FICHIER 




QUAND LE nCHIER EST EFFACE CET ENREGISTREMENT 




ESTEGALASO 


$01-$0F 


NOM DU nCHIER (ASCII POSITIF) 


$10 


TYPE DE nCHIER 




$00 


UNK PAS DE TYPE DE FICMER 




$01 


BAD 


nCHIER BLOC S DEFECIUEUX 




$02 


PCD 


nCHIER CODE PASCAL 




$03 


PTX 


nCHIER TEXTE PASCAL 




$04 


TXT 


nCHIER TEXTE (ASCII POSITIF) 




$05 


PDA 


nCHIER DE DATAS PASCAL 




$06 


BIN 


FICHIER BIN AIRE (IMAGE BIN. 8 BITS) 




$07 


FNT 


SOS (APPLE 3) nCHIER FONT 




$08 


FOT 


nCHIER FOTO SOS (APPLE 3) 




$09 


BA3 


PROGRAMME BUSINESS BASIC 




$0A 


DA3 


nCHIER DATAS BUSINESS BASIC 




$0B 


WPF 


FICHIER TRAITEMENT DE TEXTE 




$0C 


SOS 


nCHIER SYSI'EM SOS (APPLE 3) 




$0F 


DIR 


nCHIER SOUS-CATALOGUE 




$10 


RPD 


nCHIER DATAS RPS 




$11 


RPI 


nCHIERDMDEXRPS 




$12 


AFD 


FICHIER DISCARD APPLERLE 




$13 


AFM 


nCHIER MODEL APPLEFILE 




$14 


AFR 


FICHIER FORMAT DE RAPPORT APPLEFILE 




$15 


SCL 


nCHIER SCREEN LIBRARY 




$19 


ADB 


nCHIER BASE DE DONNEES APPLEWORKS 




$1A 


AWP nCH. i RAITEMENT DE TEXTE APPLEWORKS 
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Numero 






RelaHfde 






L'OCTETdans 






L'Enregistrement 








$1B 


ASP 




SAB 


GSB 




$AC 


TUP 




$AD 


BDP 




$B0 


SRC 




$B1 


OBJ 




$B2 


LIB 




$B3 


S16 




$B4 


RTL 




$B5 


EXE 




$B6 


PIP 




$B7 


TIP 




$B8 


NDA 




$B9 


CDA 




$BA 


TOL 




$BB 


DRV 




SBC 


GLP 




SBD 


PST 




SCO 


PNT 




SCI 


PIC 




SC8 


PON 




$C9 


PND 




$CA 


ICN 




SCB 


AIP 




SEE 


R16 




SEP 


PAS 




SFO 


CMD 




SFl 






$F8 






SF9 


O.S 




SPA 


INT 




SPB 


IVR 




SFC 


BAS 




SFU 


VAR 




SPE 


REL 




SPP 


SYS 


$11-$12 


POINTEUR 



SIGNinCATION 



nCHIER TABLEUR APPLEWORKS 

nCHIER PROGRAMME GS BASIC 

nCHIER DEHNITION TOOLBOX GS BASIC 

nCHIER DAT AS GS BASIC 

nCHIER SOURCE APW 

nCHIEROBJETAPW 

nCHIER BIBLIOTHEQUE APW 

nCHIER SYSTEM GS/OS 

BIBLIOTHEQUE RUN-TIME APW 

nCHIER EXECUTABLE APW 

PICHIER INIT PERMANENT GS/OS 

nCHIER INIT TEMPORAIRE GS/OS 

nCHIER NEW DESK ACCESSORY 

nCHIER CLASSIC DESK ACCESSORY 

nCHIER OUTIL GS/OS 

nCHIER DRIVER GS/OS 

nCHIER LOAD GS/OS 

PICHIER HLE SYSTEM TRANSLATOR GS/OS 

PICHIER IMAGE SHGR COMPRESSE 

nCHIER IMAGE SHGR 

FONT GS/OS 

nCHIER DATAS FINDER 

nCHIERICONE 

nCHIER AUDIO INTERCHANGE FORMAT 

nCHIER OBJET RELOGEABLE EDASM 816 

PARTITION PASCAL SUR UN VOLUME 

nCHIER COMMANDE BASICSYSTEM 



TYPES DE nCHIERS A DEFINIR 



SYSTEME D'EXPLOITATION GS/OS 
nCHIER PROGRAMME BASIC INTEGER 
nCHIER DE VARIABLES BASIC INTEGER 
nCHIER PROGRAMME BASIC APPLESOFT 
nCHIER DE VARIABLES BASIC APPLESOFT 
PICHIER RELOGEABLE CODE EDASM 
nCHIER SYSTEME PRODOS 8 



: SUR LE BLOC CLE' 
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Numero 

Relatifde 

L'OCTETdans 

L'Enregistrement 



SIGNinCATION 



$13-$14 



$15-$17 
$18-$19 

$1A-$1B 

$1C 
$1D 

$1E 



NUMERO DE BLOC DU BLOC CLE D'UN FICHIER 

DANS LE CAS D'UN HCHIER "SEEDLING" CEST LE 
NUMERO DE BLOC DU SEUL BLOC DE DAT AS 

DANS LE CAS D'UN HCHIER "SAPLING" CEST LE 
NUMERO DE BLOC DU BLOC D'INDEX 
POUR LES FICHIERS "TREE" CEST LE NUMERO DE 
BLOC DU BLOC D'INDEX MASTER 

POUR UN SOUS-CATALOGUE CEST LE NUMERO DE 
BLOC DE SON PREMIER BLOC 



TAILLE DU FICHIER EN NOMBRE DE BLOCS 

ON Y INCLUT LES BLOCS D'INDEX ET LES BLOCS 
DE DAT AS 

SI LE nCHIER EST UN SOUS CATALOGUE CEST LE 
NOMBRE DE BLOCS DE CE SOUS CATALOGUE 



EOF (END OF FILE) - TAILLE DU FICHIER EN OCTETS 
(OCTETS DE POIDS FAIBLE EN TETE) 



DATE DE CREATION DU HCHIER 

YYYYYYYMMMMDDDDD CHAQUE LETTRE EST UN ELE- 
MENT BINAIRE (Y=ANNEE, M=MOIS, D=JOUR) 

HEURE DE CREATION DU HCHIER 

OOOHHHHHOOMMMMMM (HEURES/ MINUTES) 

VERSION PRODOS A LA CREATION DU FICHIER 

VERSION MINIMUM DE PRODOS POUR LE HCHIER 

CODE D'ACCES POUR CE HCHIER 



k* 
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$80 : LE FICHIER PEUT ETRE DETRUIT 

$40 : LE FICHIER PEUT ETRE RENOMME 

$20 : FICHIER MODIHE DEPUIS LE DERNIER BACKUP 

$02 : AUTORISATION D'ECRITURE DANS LE HCHIER 
$01 : AUTORISATION DE LECTURE DU FICHIER 

EN GENERAL LE CODE D'ACCES D'UN FICHIER NON 
VERROUILLE EST $C3 ($80 + $40 + $02 + $01) - UN 
nCHIER VERROUILLE A UN CODE D'ACCES DE $01 

$1 F-$20 TYPE DE HCHIER AUXILI AIRE 

SA SIGNIFICATION DEPEND DU TYPE DE FICHIER 



TXT 
BIN 
BAS 
VAR 
SYS 



LONGUEUR DU FICHIER TEXTE 

ADRESSE DE CHARGEMENT D'UNE IMAGE BINAIRE 
ADRESSE DE CHARGEMENT D'UN PROGRAMME BASIC ($801 ) 
ADRESSE DE CHARGEMENT D'UN HCHIER DE VARIABLES 
ADRESSE DE CHARGEMENT D'UN PROG. SYSTEME ($2000) 



$21-$24 



$25-$26 



DATE/HEURE DE DERNIERE MODIHCATION DU HCHIER 
MEME FORMAT QUE POUR LA CREATION 

NUMERO DE BLOC DU BLOC CLE DU CATALOGUE 
CONTENANT L'ENTREE DU FICHIER 



5.1.16 Code d'acc^s Fichier 

Pour chaque entree de fichier au catalogue, I'octet relatif $1E permet 
de definir les operations possibles pour ce fichier. Le bit de I'octet 
identifie la lecture, le bit 1 1'ecriture, le bit 6 la possibility de renommer 
le fichier, et le bit 7 la possibility de detruire ce fichier. Si la valeur d'un 
bit est ^ 1, ProDos autorise 1' operation associee k ce bit. 

Le bit 2 indique si le fichier doit etre considere comme visible ou 
invisible. Si ce bit est h 1, les sous-routines de catalogue d'un disque 
ignorent ce fichier. 

Le bit 5 indique si ce fichier a ete modifi^ depuis sa derni^re copie. 
C'est bien entendu au programme de copie de mettre ce bit k quand 
il realise une copie de ce nchier. 

Les bits 3 et 4 ne sont pas utilises et doivent toujours etre k 0. 
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7 


6 


5 


4 3 


2 


1 





D 


r 


B 





I 


W 


R 



Si le bit correspondant est ^ 1: 



D = Autorisation de destruction 
r = Autorisation de renommer 
B = Backup necessaire 



I = Invisibility du fichier 
W = Autorisation d'^criture 
R = Autorisation de lecture 



Les commandes BASIC.SYSTEM LOCK et UNLOCK affectent I'^tat 
du code d'acc^s fichier : LOCK interdit I'^criture, la fonction Rename 
et la fonction Destroy; UNLOCK les autorise k nouveau. 

II n'y a pas de commandes BASIC.SYSTEM pour modifier individuel- 
lement chacun de ces bits, par contre nous verrons plus loin que Ton 
peut le faire avec la commande SetFilelnfo de ProDos 8 ou de GS/OS. 

Si un bit est k I, la fonction attribuee k ce bit est autoris^e; s'il vaut 
la fonction n'est pas autoris^. Les bits 4 et 3 (bits reserves) doivent 
toujours etre k 0. 

Si les bits D, r, et W sont tous ^ 1, on dit que le fichier n'est pas 
verrouille; s'ils sont tous les trois k 0, alors ce fichier est verrouUl^. 
Toutes autres combinaisons signifient que ce fichier k des limitations 
restrictives d'acc^s. 

Le bit d'invisibilite concerne les routines de catalogue d'un volume 
qui g^rent les f ichiers caches appeMs aussi f ichiers invisibles. Si ce bit 
est k 1, la routine de catalogue ne doit pas faire apparaitre ce fichier 
dans le listing. 

ProDos 8 et GS/OS mettent automatiquement ^ 1 le bit de Backup (B) 
d^s qu'il ecrivent une data dans un fichier. Cela donne la possibilite 
d'ecnre des programmes de copie qui ne recopient que les fichiers 
ayant ete modifies. C'est aux programmes de copie en question de 
remettre le bit B k dfes que la copie du fichier a ete faite. 

5.1.17 Organisation des Datas d'un Fichier : Structures de fichier 

Le travail principal de ProDos et de GS/OS est de connaitre les 
numeros des blocs qui constituent un fichier. Le syst^me d'exploita- 
tion k une technique d'index pour retrouver ces blocs. En general 
(pour les fichiers ayant un nombre de blocs de datas compris entre 2 
et 256), le pointeur sur le Bloc cle dans 1' entree du fichier au catalogue 
(octets relatifs $11 et $12) pointe sur un bloc d'index contenant une 
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liste ordonnee des numeros de tous les blocs que le f ichier utilise pour 
ranger ses datas. L'avantage principal de cette technique d'index, 
c'est qu'un fichier p>eut occuper sur un volume une serie de blocs qui 
ne sont pas necessairement cons^cutifs (par exemple le syst^me d'ex- 
ploitation Pascal oblige I'utilisation de blocs consecutifs pour le ran- 
gement des datas). Cela signifie que Ton ne perd pas d'espace sur le 
volume disque. L'inconvenient est que les operations disque I/O sont 
plus lentes car il est necessaire de positionner la tete de lecture/ 
ecriture sur tous les blocs disperses sur le volume d'un fichier frag- 
mente. Pour defragmenter un fichier il existe I'utilitaire Beach Com- 
ber de Glen Bredon (sur un disque dur cela peut faire gagner 6norm^ 
ment de temps). 

II existe 3 types de structures de fichier d^pendantes de la taille du 
fichier auquel le syst^me doit acceder : 



- Fichier "Seedling" : 1 ^ 512 octets (1 Bloc de Datas) 

- Fichier "Sapling" : 513 k 131072 octets (128 Ko - maximum 256 

blocs) 

- Fichier "Tree" : 131073 k 16777215 octets (16 Mb-1 32768 

blocs maxi) 



On peut determiner la technique d'index utilisee par un fichier (autre 
qu'un sous-catalogue) en examinant les 4 bits de poids fort du code de 
type d'enregistrement stockes dans I'octet relatif $00 dans une entree 
de fichier au catalogue. Ce nombre est egal k $1 pour un fichier 
"Seedling", $2 pour un fichier "Sapling", et $3 pour un fichier 'Tree" . 
Si ce nombre est egal k $0 le fichier a ete efface. Les fichiers sous- 
catalogues utilisent les codes $D, $E, ou $F; $D identif ie une entree au 
catalogue pour un fichier sous-catalogue, $E un sous-catalogue, et $F 
le catalogue du volume. Le code $4 identifie une partition Pascal et le 
code $5 identifie un fichier de type etendu. 

Le pomteur cle d'un fichier (octets relatifs $11 et $12) pointe sur un 
bloc d'index (aussi appele Bloc cle). Nous allons maintenant exami- 
ner comment le systeme d'exploitation utilise le bloc d'index pour 
chacun de ces trois types de fichier. 

Fichier "Seedling" - fichier de 1 ^ 512 octets (1 bloc). Ce type de fichier 
utilise un bloc unique pour ses datas; c'est le numero de Dloc indiqu6 
par le pointeur cle (octets relatifs $11 et $12). 
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Par exemple, creons le programme Basic Applesoft suivant: 



10 
20 
30 
40 
50 
60 
70 



PRINT CHR$(4); «OPEN TXTFILE,L64» 

FOR I = TO 2 

PRINT CHR$(4); «WRITE TXTFILE,R»;I 

PRINT «RECORD»;I 

NEXT I 

PRINT CHR$(4); «CLOSE TXTnLE» 

END 



BLOCDE 
DATAS 



TAILLE MAXIMUM 
DUnCHIER 
= 512 OCTETS 



$lx 











$00 

TYPE 

D'ENREGISTREMENT 

(4 BITS DE 

POIDSFORT) 



$11 $12 

POINTEUR 

SURLE 

BLOC DE DATAS 



NUMERO 

OCTET 

RELATIF 



Ce petit programme cree un fichier texte appele «TXTFILE» avec des 
enregistrements d'une longueur de 64 octets. II ecrit ensuite dans ce 
fichier 3 enregistrements contenant les chaines de caract^res "RE- 
CORDO", "RECORDl", et "RECORD2". La taille totale de ce fichier 
est de 3 fois 64 octets soit 192 octets. Ce nombre etant inferieur ^512 
octets, ce fichier sera sauvegarde sous forme de fichier "Seedling". 

Fichier "Sapling" - Le pointeur cle d'un fichier "Sapling" pointe sur 
un numero de bloc qu'on appelle le bloc d'index. Ce bloc d'index 
contient une liste ordonnee de numero de blocs utilises pour le 
rangement des datas de ce fichier. Deux octets sont necessaires pour 
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stocker chaque numero de bloc. La partie basse du numero de bloc est 
toujours stockee dans la premiere partie de ce bloc d'index; la partie 
haute du numero de bloc est stockee dans la deuxi^me partie du bloc 
d'index. La taille maximum d'un fichier "Sapling" est cie 128 Ko; il ne 
peut pas etre plus important car un bloc d'index ne peut r^fererencer 
au maximum que 256 blocs. 

Reprenons notre exemple de tout k I'heure, et modifions la ligne 20 
par : 



BLOC INDEX 
PARTIE BASSE 



BLOC INDEX 
PARTIE HAUTE 



n 



."D, I 

I 

j — \ 



BLOC D'INDEX 

256 POINTEURS 

MAXIMUM 



$2x 











$00 

TYPE 

D'ENREGIS- 

TREMENT 

(4bits de poidsfort) 



$11 $12 < 


f 'Numero 


POINTEUR 


d'OCTET 


SURLE 


RELATIF 


BLOC 




D'INDEX 





r 



BLOCDE 

DATA 





BLOCDE 

DATA 

N 
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; 



20 FORI = TO 100 

Relangons le programme par I'instruction RUN. Le fichier cr^ con- 
tient maintenant 101 enregistrements de 64 octets chacun; la taille 
totale du fichier 'TXTFILF' est done de 6464 octets. Quand le neu- 
vi^me enregistrement est ecrit (RECORDS), le syst^me d'exploitation 
(ProDos ou GS/OS) se rend compte que le bloc "Seedling" original est 
plein. Le syst^me d'exploitation va alors cr6er ce que Ton appelle un 
bloc d'index. Ce bloc contient tous les num^ros de blocs de chaque 
blocs de donnees pour le fichier 'TXTFILE" dans I'ordre dans lequel 
le syst^me d'exploitation va y acceder. En utilisant un bloc d'index, le 
syst^me d'exploitation peut acceder k un fichier dans un ordre se- 
quential meme si ses blocs de datas ne sont pas physiquement conti- 
gus (I'un apr^s 1' autre sur le disque). 

Ainsi, dans notre exemple, un nouveau bloc est attribu4 pour le bloc 
d'index (par exemple le bloc $A; on suppose que les datas du fichier 
de type "Seedling* etaient stock^s en bloc $08). Les blocs $B k $16 
sont utilises pour la sauvegarde des datas suivantes du fichier 
"TXTFILE". Ce sont ces numeros de blocs qui sont places dans le bloc 
d'index ($A). Bien entendu. Ten tree au catalogue pour le fichier 
'TXTFILE" est mise k jour pour que le bloc cle pointe sur le bloc 
d'index (octets relatifs $11 -$12); le fichier est maintenant identifi6 
commeetant "Sapling" (4 bits depoids fortdel'octetrelatif $00). Dans 
le bloc d'index, les numeros de dIocs point^s sont stock^s en deux 
parties : le poids faible des numeros de blocs sont dans la premiere 
partie du bloc d'index (de I'octet relatif $000 k $OFF); le poids fort de 
ces memes numeros sont dans la deuxi^me partie du bloc d'index (de 
I'octet relatif $100 k $1FF). 
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BLOC$A 

pOOC 080B0C0D0E0F101112131415 
' 018 160000 000000000000000000 
024 000000 0000000000 00000000 
030 0000000000000000 00000000 
03C 000000000000000000000000 
048 000000000000000000000000 
054 000000000000000000000000 
060 000000000000000000000000 
06C 00 000 000000000 00 00 00 
078 000000000000000000000000 
084 000000000000000000000000 
090 000000 0000000000 00000000 
09 C 000000 0000000000 00000000 
0A8 000000000000000000000000 
0B4 000000 000000000000000000 
OCO 000000000000000000000000 
OCC 0000000000000000000000 
0D8 000000000000000000000000 
0E4 000000000000000000000000 
OFO 000000000000000000000000 
l_J)FC 0000000 



lERBLOCDEDATAS 
DUFICHIER: 

$0008 
POIDSFAIBLE $08 
POIDSFORT $00 



)RT 



DERNIER BLOC DE 
DMAS : 

$0016 
POIDSFAIBLE $16 
POIDSFORT $0 



|~0 

c 

8 
4 


c 





1 

2 

3 

3 

48 

54 

60 

6C 

1 78 

1 84 

1 9 

1 9 

1 A8 

1 B4 

ICO 

1 cc 

1 D8 
1 E4 
1 FO 
1 FC 




C 



000 
000 
000 
000 
000 
000 
000 
000 
000 
000 
000 
000 
000 
000 
00 
000 
000 
000 
000 
000 
000 
00 



000 
000 
000 
000 
000 
000 
000 
000 
000 
000 
000 
000 
000 
000 
000 
000 
000 
000 
000 
000 
000 




000 
000 
000 
000 
000 
000 
000 
000 
000 
000 
000 
000 
000 
000 
000 
000 
000 
000 
000 
000 
000 
00 



000 
000 
000 
000 
000 
000 
000 
000 
000 
000 
000 
000 
000 
000 
000 
000 
000 
000 
000 
000 
000 



000 
000 
000 
000 
000 
000 
000 
000 
000 
000 
000 
000 
000 
000 
000 
000 
000 
000 
000 
000 
000 



00 
000 
000 
000 
000 
000 
000 
000 
000 
000 
000 
00 
00 
00 
00 
000 
00 
00 
000 
000 
00 



000 
000 
000 
000 
000 
000 
000 
000 
000 
000 
000 
000 
000 
000 
000 
000 
000 
000 
000 
000 
000 



000 
000 
000 
000 
000 
000 
000 
000 
000 
000 
000 
000 
000 
000 
000 
000 
000 
000 
000 
000 
000 



Dans un bloc d'index, pour trouver un bloc de datas, il suffit de 
prendre I'octet N pour le poids faible du num^ro de bloc, et I'octet 
relatif N + 256 pour le poids fort de ce numero de bloc. 
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I 



r 



$3x 











BLOC INDEX 
PARTIE BASSE 



BLOC INDEX 
PARTIE HAUTE 



n 
I 

J 



BLOCDTNDEX 
MAITRE 



$00 



$11 $12 



i- 
Numero 



I 



d'CXTTET 
^^. POINTEUR '^^L^^'^ ' 

REGISTREMENT SURLEBLOC 1 

(4bitsdepoidsfort) D'INDEX MAITRE 



I 

I PARTIE BASSE 

I 

PARTIE HAUTE 



£ 






POINTEURS 
BLOC DATA 



:-r„r^.rr-^ 



POINTEURS 
BLOC DATA 



r 



BLOC INDEX 



^ 



r 



-i 



-I 



n 



I 



- POINTEURS 
BLOC DATA 

POINTEURS 
BLOC DATA 



n 



BLOC INDEX N 



r 



I 

1 



BLOC DATA BLOC DATA 255 



BLOC DATA X BLOC DATA N 
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Fichier "Tree" - Pour un fichier de type 'Tree", le Pointeur Cle pointe 
sur le numero de bloc d'ur\ bloc d'index maitre, qui contient une liste 
ordonnee de tous les numeros de blocs d'index. La taille maximum 
d'un fichier "Tree" est de 16 MO. 

Supposons maintenant que nous modifions encore une fois notre 
programme Basic pour que 2144 enregistrements soient crees (ligne 
20 du programme). Cela va donner une taille de fichier de 137216 
octets, Di en plus que ce que peut decrire un bloc d'index unique. Le 
syst^me d' exploitation doit done "promouvoir" notre fichier 
"TXTFILE" au niveau de hierarchie suivant, c'est h dire un fichier de 
type "Tree". Un fichier 'Tree" consiste en un bloc d'index maitre 
unique reference dans I'Entree au Catalogue par le Pointeur Cl^. Ce 
bloc d'index maitre contient les numeros de blocs des blocs d'index. 
Ces blocs d'index decrivent comme auparavant les numeros des 
blocs de datas qui constituent notre fichier. Un bloc d'index maitre 
peut decrire 256 dIoc d'index, chacun d'entre eux pouvant decrire 256 

BLOC $010 A - BLOC D'INDEX MAITRE 



000 OAOBOOOOOOOOOOOOOOOOOOOO DEUX BLOCS D'INDEX 

OOC 000000000000000000000000 $000A-$010B 

018 000000000000000000000000 

024 000000000000000000000000 

030 000000000000000000000000 

03C 000000000000000000000000 

048 000000000000000000000000 



blocj 
100 


; de datas. 

000100000000000000000000 


lOT 


000000000000000000000000 


118 


000000000000000000000000 


124 


000000000000000000000000 


nn 


000000000000000000000000 


^^c 


000000000000000000000000 


148 


000000000000000000000000 


IFC 


1 

00000000 
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BLOC $000A - BLOC D'INDEX 



BLOC $010B - BLOC D'INDEX 1 



000 080B0C0D0E0F101 112131415 

OOC 161718191A1B1C1D1E1F2021 

018 22232425262728292A2B2C2D 

024 2E2F3031 3233343536373839 

030 3A3B3C3D3E3F404142434445 

03C 464748494A4B4C4D4E4F5051 

048 52535455565758595A5B5C5D 

100 000000000000000000000000 

IOC 000000000000000000000000 

118 000000000000000000000000 

124 000000000000000000000000 

130 000000000000000000000000 

13C 000000000000000000000000 

148 000000000000000000000000 



000 OCODOEOFlOl 1121314151617 

OOC 000000000000000000000000 

018 000000000000000000000000 

024 000000000000000000000000 

030 000000000000000000000000 

03C 000000000000000000000000 

048 000000000000000000000000 

100 010101010101010101010101 

IOC 000000000000000000000000 

118 000000000000000000000000 

124 000000000000000000000000 

130 000000000000000000000000 

13C 000000000000000000000000 

148 000000000000000000000000 



IFC 00000000 



IFC 00000000 



BLOC $0008 - BLOC DATA 

000 5245434F5244300D00000000 RECORDO 

OOC 000000000000000000000000 

018 000000000000000000000000 

024 000000000000000000000000 

030 000000000000000000000000 

03C 000000005245434F5244310D ....RECORDl. 

048 000000000000000000000000 



BLOC $01 1 7 - BLOC DATA 267 



000 
OOC 
018 
024 
030 
03C 
048 



5245434F5244323133360D00 RECORD2136.. 

000000000000000000000000 

000000000000000000000000 

000000000000000000000000 

000000000000000000000000 

000000005245434F52443231 ....RECORD21 

33370D000000000000000000 37 
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II faut remarquer ici que le bloc d' index original du fichier "Sapling" 
(bloc $A) est devenu le pren\ier Bloc d'lndex du fichier 'Tree". Au 
moment du chan^ement de type de fichier, le bloc d'lndex maitre a 6te 
attribue en premier ($10 A), puis le second Bloc d'lndex ($10B), et 
enfin le premier bloc de data du second bloc d'index ($10C). Le 
dernier bloc utilisepour notre fichier 'TXTFILE" est pour les enregis- 
trements "RECORD2136" k "RECORD2143" (pour un total de 2144 
enregistrements). 

5.1.18 Les Sous-Catalogues ou fichiers de type DIR 

Nous avons vu que le catalogue principal d'un volume ProDos ou 
GS/OS ne peut pas contenir plus de 51 entrees. Sans I'utilisation de 
sous-catalogues cette limite ne pourrait pas etre d^pass^e. II faut con- 
siderer un sous-catalogue comme une extension du catalogue princi- 
pal du volume. Dans le cas le plus simple, un sous-catalogue est cree 
et est considere comme une entree plac^ dans le catalogue principal 
du volume. Le sous-catalogue a une structure tr^s similaire au cata- 
logue principal : il a une entete placee au debut, ses blocs sont 
doublement references par des pointeurs sur les 4 premiers octets de 
chaque bloc qui le constitue, et il peut contenir des entries pour 
d'autres fichiers (ainsi que des sous-catalogues). Contrairement au 
catalogue principal du volume, il peut avoir une longueur quelcon- 
que (au moment de la creation il est constitue par un bloc unique 
auquel on ajoute d'autres blocs quand la taille du sous-catalogue aug- 
mente), son entete a une structure leg^rement diff^rente que I'entdte 
du catalogue principal du volume, il peut etre situe n'importe ou sur 
le Volume, et enfin ses blocs ne sont pas n^cessairement contigus. 
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Void un diagramme d'une structure classique de sous-catalogues 



BLOC 2 



r 



r 



^=^ 



nCHIER 



CATALOGUE PRINCIPAL 
DU VOLUME 




\ 



J f 



l_ 



I 



— cJ>nCHIER 

ci>AUTRES 

nCHIERSOU 
SOUS- 
CATALOGUE 
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On peut voir qu'avec un seul sous-catalogue on peut creer autant de 
fichiers que Ton a de blocs disponibles sur le Volume. En principe, il 
est preferable de creer une arborescence de sous-catalogues, chaque 
sous-catalogue renfermant un certain genre de fichier; fichiers ta- 
bleur, dessins, programmes personnels, etc ... 

On peut considerer ces sous-catalogues comme de mini volumes h 
I'interieur d'un volume d'une taille oeaucoup plus importante. 

Void la description de la structure de I'entete d'un sous catalogue; les 
4 premiers octets de chaque bloc de sous-catalogue pointent pour les 
deux premiers octets (octets $00-$01) sur le bloc precedent de ce sous- 
catalogue, les octets $02-$03 pointent sur le bloc suivant de ce sous- 
catalogue. 



Numero 
de I'octet 

dans 
le Bloc Cle 



ENTETE D'UN SOUS-CATALOGUE 



SIGNinCATION 



$04 



$05-$13 

$14 

$15-$1B 

$1C-1D 

$1E-$1F 



4 BITS PD FORT: TYPE D'ENREGISTREMENT 
$F = CATALOGUE VOLUME 
$E = SOUS CATALOGUE 

4 BITS PD FAIBLE: LONGUEUR DU NOM DU VOLUME 
IL SE TROUVE DANS LE CHAMP SUIVANT 



NOM DU SOUS-CATALOGUE: 15 OCTETS (ASCII POSITIF) 
LA LONGUEUR DE CE NOM EST DANS L'OCTET $04 
LE RESTE DE CET ENREGISTREMENT EST IGNORE 
/ N'EST PAS UTILISE ICI 

DOITCONTENIR$75 

RESERVE POUR UNE UTILISATION FUTURE 
EN GENERAL REMPLI AVEC DES 00 

DATE DE CREATION DU CATALOGUE (FORMATAGE) 
YYYYYYYMMMMDDDD (Y=ANNEE, M=MOIS, D=JOUR) 
FORME BINAIRE 

MINUTE ET HEURE DE CREATION DU CATALOGUE 
OOOHHHHHOGMMMMMM (H=HEURE, M=MINUTE) 
FORME BINAIRE 
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suite entete d 'un sous-catalogue 

Numero 

de I'octet dans 

leBlocCle 



SIGNinCATION 



$20 
$21 
$22 



$23 



$24 



$25-$26 



$27-$28 



$29 



$2A 



VERSION DE PRODOS QUI A CREEE CE SOUS CATALOGUE 

VERSION MINIMUM DE PRODOS POUVANT UTILISER 

CE SOUS CATALOGUE 

CODE D'ACCES PRODOS (VOIR PLUS LOIN) 

$80 LE SOUS-CATALOGUE PEUT ETRE REFORMATE 

$40 LE SOUS-CATALOGUE PEUT ETRE RENOMME 

$20 LE SOUS-CATALOGUE A ETE MODIHE DEPUIS LE 
DERNIER BACKUP 

$02 AUTORISATION D'ECRITURE SUR LE SOUS-CATALOGUE 
$01 AUTORISATION DE LECTURE SUR LE SOUS-CATALOGUE 



LE NOMBRE D'OCTETS UTILISES PAR CHAQUE ENTREE 
DANS LE SOUS-CATALOGUE ($27) 



LE NOMBRE D'ENTREE SUR CHAQUE BLOC DE 
SOUS-CATALOGUE ($OD).L'ENTETE DU SOUS-CATALOGUE EST 
CONSIDERE COMME UNE ENTREE 



NOMBRE D'ENTREES ACTIVES DANS LE SOUS-CATALOGUE 
SANS COMPTER L'ENTETE DU SOUS-CATALOGUE 
UNE ENTREE ACTIVE DECRIT UN HCHIER OU UN SOUS 
CATALOGUE NON EFFACE. 



DANS UN SOUS CATALOGUE C'EST LE POINTEUR INDIQUANT 
LE BLOC DEFINISSANT L'ENTREE DE CE SOUS-CATAL(X^UE 
DANS LE VOLUME PRINCIPAL OU UN SOUS-CATALOGUE 

NUMERO DE L'ENTREE FICHIER DANS LE NUMERO DE 

BLOC POINTE PAR LES OCTETS $27-$28 

CE NOMBRE EST COMPRIS ENTRE $01 ET $0D 

LONGUEUR DES ENTREES DANS LE CATALOGUE PERE 
EN GENERAL $27 (NOMBRE D'OCTETS) 
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5.1.19 Fichiers Etendus 

GS/OS (mais pas ProDos 8) peut creer des fichiers de type etendu. Ces 
fichiers ont un code pour le type d'enregistrement de $5. Un fichier 
Etendu comprend deux segments de donn^es, le segment de res- 
source et le segment de donnees. Le segment de donnees contient en 
general les donnees specifiques de 1' application elle meme. Le seg- 
ment de ressource contient en g^n^ral les structures de donnees defi- 
nissables; ces structures de donnees definissent des elements comme 
par exemple les definitions de menu, les boites de dialogue, etc ... 

Le bloc cle pour un fichier Etendu n'en est pas vraiment un; c'est 
simplement une extension de I'entree du fichier au catalogue. La 
premiere moitie du bloc contient les informations du segment de 
donnees; la deuxi^me moitie contient les informations relatives au 
segment de ressource. GS/OS utilise seulement les huit premiers 
octets de chaque moitie de bloc. Void la signification de chacun de ces 
octets : 

$00 CODE DU TYPE D'ENREGISTREMENT POUR LE SEGMENT 

$01-$02 NUMERODU BLOC CLE POUR LE SEGMENT 

$03-$04 TAILLE DU SEGMENT (NOMBRE DE BLOCS) 

$05-$07 TAILLE DU SEGMENT (NOMBRE D'OCTETS) 

Le code du type d'enregistrement pour le segment est soit $01 (See- 
dling), $02 (Sapling), ou $03 (Tree). Le bloc cH pour le segment d'un 
fichier etendu (octets $01 -$02) est organise de la meme faqon que un 
fichier de type classique. 

5.1.20 Les fichiers Sparse 

II est possible de creer des fichiers qui ne sont pas sequentiels. Cela 
signifie qu'ils sont constitues d'une s^rie d'enregistrements (dont on 
peut choisir la taille); on peut lire ou 6crire sur n'importe le quel de ces 
enregistrements sans avoir h se positionner sur les precedents. Cela 
signifie que Ton peut ecrire dans un enregistrement meme si celui ci 
est separe de I'enregistrement ^crit pr^c^demment par un grand 
nombre d'enregistrements vides (remplis de 00). Bien entendu, le 
syst^me d'exploitation de sauvegarde pas les enregistrements vides 
car cela prendrait ^normement de place sur le volume. En fait, dans le 
bloc d'index il place des $0000 pour indiquer les blocs de datas qui ne 
sont pas utilises; il le seront quand ces enregistrements seront ecrits. 

Ce genre de fichier est appele Sparse; il n'occupe pas sur le Volume 
autant de place que sa taille I'indique. 
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Creons un fichier Sparse avec le programme en Basic Applesoft qui 
suit. On suppose que la longueur de cnaaue enregistrement est de 1 28 
octets, et que I'on ecrit seulement dans les enregistrements 2 et 64 



10 
30 
40 
50 
60 
70 
80 



F$= «RANDOM» 

PRINT CHR$ (4); «OPEN»; F$;»,L128" 

PRINT CHR$ (4); «WRITE»; F$;»,R2" 

PRINT «RECORD 2» 

PRINT CHR$ (4); «WRITE»; F$;»,R64" 

PRINT «RECORD64» 

PRINT CHR$(4); «CLOSE» 



Le bloc d'index pour le fichier cree par ce programme 
est le suivant : 



0000 8C 00000000000000 
0008 00 00 00 00 00 00 00 00 
0010 8E 00000000000000 



Cela indique que les Bios et 16 de 
datas sont ranges en Bloc $008C et $008E 
sur le Volume 



0100 0000000000000000 

0108 00 00 00 00 00 0000 00 

0110 00 00 00 00 00 00 0000 



01F8 



00 00 00 00 00 00 00 00 



BLOC DE DATAS (BLCX: $008C) 

0000 00 00 00 00 00 00 00 00 



0100 52 45 43 4F 52 44 20 32 

0108 OD 

0109 0000000000000000 



RECORD 2 



01F8 



00 00 00 00 00 00 00 00 
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L'enregistrement 2 (RECORD 2) est stocke k la position $100 (2 X 128) 
dans le fichier; cela correspond i la position $1 00 dans le premier bloc 
attribue au fichier (entr^ du bloc d'index pointant sur le bloc $008C) 



BLOC DE DATAS 16 (BLOC $008E) 



0000 


52 45 43 4F 52 44 20 36 


RECORD 6 


0008 


34 


4 


0009 


OD 




OOOA 


00 00 00 00 00 0000 00 





01F8 0000000000000000 



L'enregistrement 64 (RECORD 64) commence k la position $2000 
dans le fichier (64 X 128); cela correspond k la position $0000 de la 
16 kme entree du bloc d'index qui pointe sur le bloc de datas $008E. 
Les 15 blocs inutilises entre ces deux enregistrements sont indiques 
par des $0000 dans les entrees du bloc d'index. 

Ainsi, meme si logiquement ce fichier a une longeur de 17 blocs, le 
syst^me d'exploitation en utilise seulement 3 pour le sauvegarder sur 
le volume (1 pour le bloc d'index, et 2 pour les blocs de datas). 
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5.2 Les commandes de GS/OS et de ProDos 8 

GS/OS et ProDos 8 ont tous les deux un interpreteur de comman- 
des de bas niveau. 

L' interpreteur de commandes de ProDos 8 s'appelle le M.L.I. (Ma- 
chine Language Interface). Le MLI reconnait 26 commandes. 

GS/OS reconnait 47 commandes. 

On peut appeler ces differentes commandes k partir d'un pro- 
gramme en langage machine k I'aide d'une technique generale 
utilisant des protocoles d'appel definis par Apple. 

Les protocoles pour ProDos 8 et GS/OS sont de structures similai- 
res mais pas identiques. 

Dans cette partie, nous allons examiner de tr^s pr^s les commandes 
de GS/OS et de ProDos 8, et voir comment on les utilise dans les 
programmes en Langage machine. 



5.2.1 Utilisation des commandes MLI de ProDos 8 

II est tr^s facile d'executer une commande MLI k partir de ProDos 
8. Une sequence typique d'appel ressemble k quelque chose comme 
eel a : 



— > Placer les valeurs dans la table des param&tres 
avant d' appeler la commande MLI. 



JSR $BFOO POINT D' ENTREE MLI 

DFB CMDNUM NUMERO DE COMMANDE MLI 

DA PARMTBL ADRESSE DE LA TABLE DE PARAM£TRES 

BCS ERROR RETENUE = 1 EN CAS D'ERREUR 
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— > Suite du programme 



RTS 
ERROR — > Routine de traitement d'erreurs 



RTS 

PARMTBL DFB NPARMS NOMBRE DE PARAMETRES DANS LA TABLE 

DESPARAMETRES 



On place dans cette table (PARMTBL) les param^tres dans I'ordre 
attendu par la commande MLI. 

L'instruction cle est le JSR $BFOO. 

$BFOO est I'adresse du point d'entree du MLI en memoire princi- 
pale. L'interpreteur MLI determine h quelle commande 1' applica- 
tion a fait appel et passe alors le controle k la sous routine ProDos 8 
correspondante pour traiter cette commande. 

D&s que le MLI prend le controle, il modif ie 4 variables imoortantes 
dans la page globale ProDos 8 : MLIACTV ($BF9B), CMDADR 
($BF9C-$BF9DX SAVEX ($BF9E), et SAVEY ($BF9F). 

Le MLI modifie le bit 7 de MLIACT; il passe de ^ 1 afin qu'une sous 
roudne de gestion d' interruption puisse determiner si une condi- 
tion d'interruption survient pendant le deroulement d'une opera- 
tion MLI. 

Le MLI sauvegarde ensuite la valeurs des registres d'index X et Y 
dans SAVEX et SAVEY. 

Enfin, le MLI range I'adresse de l'instruction suivant immediate- 
men t les 3 octets apr^s ^instruction JSR $BFOO en CMDADR. Le 
controle pa?sera k cette adresse apr^s I'execution de la commande 
MIL 
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Le MLI determine quelle commande il doit traiter en examinant la 
valeur rangee dans I'octet qui suit imm^diatennent I'instruction JSR 
$BFOO. Cette valeur est un code unique identifiant un num^ro de 
commande. 

Si le MLI rencontre un numero de commande inconnu, une erreur 
systfeme survient. 

Les deux octets suivants le numero de commande contiennent 
I'adresse (poids faible - poids fort) de la table des param&tres que 
la commande MLI va utiliser. 

Cette table debute par un octet qui indique le nombre de param^- 
tres contenus dans cette table. Le reste de la table contient des 
donnees que le MLI va utiliser pour executer la commande. 

Apr^s I'execution de la commande MLI, cette table de paramfetres 
contient les resultats retournes par le MLI. 

Nous decrirons plus loin les contenus de la table des param^tres 
pour chacune des commandes MLI. 

Les param^tres qu'une application passe au MLI sont de deux 
types: pointeurs ou valeurs. 

•Un pointeur est une valeur sur deux octets qui pointe sur I'adresse 
d'une structure de donnees, par exemple une table de datas (poids 
faible - poids fort). 

•Une valeur sur 1, 2, ou 3 octets est une quantite numerique ayant 
une signification binaire (octet de poids faible en premier). 

Les param^tres retournes par le MLI sont appeles resultats. 

Un resultat est en general une quantite numerique sur 1, 2, ou 3 
octets (octet de poids faible en premier), mais il peut s'agir aussi 
d'un pointeur sur 2 octets; tout depend de la commande MLI 
appelee. 

Si le nombre au debut de la table de param^tres ne correspond pas 
au nombre de param^tres attendus par la commande MLI, une 
erreur syst^me survient. Autrement, le MLI execute la commande. 

Pendant I'execution d'une commande, une erreur critique peut 
survenir. 

Les erreurs critiques sont tr^s rares et surviennent seulement 
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quand des zones de datas ProDos ont ite effaces par un pro- 
gramme, ou si une interruption est requise et qu'il n'y a pas de 
programme d'interruption pour la gerer. 

Avec ce genre d'erreur, on est oblige de rebooter tout le syst^me. 

Dans ce cas, le MLI execute I'instruction JSR $BFOC. 

La routine en $BFOC (SYSDEATH) fait apparaitre le message sui- 
vant : 

INSERT SYSTEM DISK AND RESTART - ERR xx 

OLi XX est un code d'erreur hexadecimal ayant 4 valeurs possibles : 

$01 = Erreur Interruption 

$0A = Bloc Controle volume endommage 

$0B = Bloc Controle Fichier endommage 

$0C = Bloc d' Allocation endommage 

II s'agit de structures de datas internes que ProDos 8 utilise pour 
manipuler les volumes disque et pour ouvrir les fichiers. 

Le MLI, une fois la commande traitee recup^re les valeurs des regis- 
tres X et Y (1' application n'a done pas besoin de les sauvegarder). 
En cas d'erreur, le MLI execute I'instruction $BF09. Cette sous 
routine (SYSERR) range un code d'erreur en $BFOF (SERR). 

Finalement, le controle est passe k I'instruction qui suit immediate- 
ment le pointeur sur la Table des Paramtoes (BCS ERROR dans 
notre exemple). 

Cette adresse a ete range par le MLI en $BF9C - $BF9D juste au d4but 
du traitement. 



5.2.2 Utilisation des commandes GS/OS 

La procedure generale d'appel d'une commande GS/OS est simi- 
laire k I'appel d'une commande MLI ProDos 8. 



ISL $E100A8 Point d'entree GS/OS 

DA COMMANDNUM Numero de Commande GS/OS 

ADRL PARMTABLE Adresse de la Table des Param^tres 

BCS ERROR Retenue = 1 en cas d'Erreur 
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$E100A8 est I'adresse du point d' entree de I'interpreteur de com- 
mandes de GS/OS. Vous pouvez appeler ce point d'entree soit en 
mode natif, soit en mode emulation (voir la partie consacree au 
micro-processeur) . 

Immediatement apr^s I'instruction JSL $E100A8, il y a le Mot con- 
tenant le numero d'indentification de la commande GS/OS que 
vous voulez utiliser. 

A la suite du numero de commande, on trouve I'adresse longue (4 
octets; octets de poids faible en premier) de la Table des Param^tres 
necessaires au fonctionnement de la commande et au rangement 
des resultats eventuels. 

Les param^tres peuvent etre des valeurs numeriques sur 1 ou 2 
Mots (un Mot est constitue de 2 octets), ou des pointeurs longs (4 
octets); ils sont ranges dans I'ordre poids faible - poids fort. 

La structure exacte de la Table des Paramfetres varie d'une com- 
mande h une autre, mais elle debute toujours par un nombre indi- 
quant le nombre de param^tres dans la table; ce param^tre s'ap- 
pelle PCOUNT. 

Lorsqu'il a termine avec le traitement d'une commande, GS/OS 
aioute 6 k I'adresse de retour placee dans la pile par I'instruction 
JSL puis revient avec une instruction RTL. 
Cela permet de passer le controle au code se trouvant apr^s le 
pointeur sur la Table des Param^tres (BCS ERROR dans notre 
exemple). 

Au retour, le contenu de tous les registres reste inchang^ sauf 1' Ac- 
cumulateur (qui contient un code d'erreur), le Program Counter 
(PC), et le registre d'etat P (les indicateurs m, x, D, I et e sont 
inchanges, N et V sont indefinis; C et Z indiquent s'il y a eu une 
erreur). 

A partir de 1^, on peut verifier I'etat de C pour determiner s'il y a 
une erreur : 

Si C = 0, il n'y a pas d'erreur 
Si C = 1, il y a eu une erreur 

On peut aussi examiner I'etat de Z. En cas d'erreur, Z = 0. 

Le code d'erreur indiquant la nature de cette erreur se trouve dans 
I'Accumulateur. 

S'il n'y a pas d'erreur, I'Accumulateur contient $00. 
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5.2.3 Les erreurs sous GS/OS et ProDos 8 

line erreur qui n'est pas une erreur critique est appelee une erreur 
syst^me. 

Ces erreurs peuvent avoir diverses origines : 

Un pathname non valide, une tentative d'ecriture sur un disque 
protege, une ouverture d'un fichier inexistant, etc... 

Si aucune erreur n'est survenue pendant I'execution d'une com- 
mande, A = 0, C = 0, et Z = 1. 

En cas d'erreur, I'Accumulateur contient le code de cette erreur C 
= 1 et Z = 0. 

Cela signifie que I'on peut utiliser un BCS ou un BNE pour se 
brancher sur une sous routine de traitement des erreurs. 
On doit toujours verifier si une erreur est survenue apr^s le traite- 
ment d'une commande ProDos 8 ou GS/OS. Si on ne fe fait pas, on 
obtient dans la plupart des cas un programme qui ne fonctionne pas 
toujours parfaitement. Pensez par exemple aux consequences d'une 
commande d'ecriture dans un fichier qui n'a pas pu etre ouvert 
parce qu'il n'existe pas. 

Voici la liste des codes d'erreur : 



$00 Pas d'erreur. 

$01 Numero de commande non valide. 

$04 Nombre de Param^tres specific dans la Table des Param^tres 
non valide. 

$07 Une commande GS/OS a ete demande par une routine d'inter- 
ruption. 

$10 Un Device specific n'a pu etre trouve. GS/OS donne cette 
erreur apr^s que la commande GetDevNum n'ait pu localiser 
un Device. 

$11 Le numero de reference du Device n'est pas valide. GS/OS 
donne cette erreur si le numero de Device n'est pas dans la liste 
des Devices actifs. 

$22 Param^tre invalide pour un Driver GS/OS. 
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$23 Le Driver "CONSOLE DRIVER" n'est pas ouvert. 

$25 La Table des vecteurs d' Interruption de ProDos 8 est pleine. 

$27 Une erreur I/O sur disque 5.25" est survenue empechant le 
transfert correct des donnees. Le volume disque est sans 
aucun doute abime. On obtient aussi cette erreur s'il 
n'y a pas de disque dans le lecteur. 

$28 Le Device disque specific n'est pas present. Cette erreur 
arrive quand on tente d'acc^der k un second lecteur quand il 
n'y aqu'un lecteur de connect^. 

$2B Une operation d'ecriture a ^choud parce que le Volume dis- 
que est protege contre I'ecriture. 

$2E Une commande a echoue parce que le Volume disque conte- 
nant un fichier ouvert a ete enleve de son lecteur. 

$2F Le Device specif ie n'est pas en ligne. Cette erreur arrive s'il 
n'y a pas de disque dans le lecteur 3.5". 

$40 La syntaxe du pathname n'est pas valide. 

$42 Tentative d'ouverture d'un 9^me fichier. ProDos 8 n'autorise 
I'ouverture que de 8 fichiers au maximum. 

$43 Le numero de reference d'un fichier n'est pas valide. Cela 
arrive auand un mauvais numero de r^f^rence est specific 
lors de I'ouverture d'un fichier ou lorsqu'un mauvais nu- 
mero de reference est specifie lors de la fermeture d'un fichier. 

$44 Le Pathname specifie n'a pas ete trouve. Cela sienifie que I'un 
des noms de sous-catalogue, dans un autre patnname valide, 
n'existe pas. 

$45 Le Volume specifie n'a pas ete trouve. Cela arrive quand par 
exemple on change le disque du lecteur. 

$46 Le fichier specifie n'a pas ete trouve. Cela signifie que le nom 
de fichier dans un Pathname correct n'existe pas. 

$47 Le nom de fichier specifie existe dej^. Cette erreur arrive 
quand on tente de renommer ou de creer un fichier, et que le 
nom utilise existe dej^. 
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$48 Le Volume disque est plein. II n'y a plus de blocs disponibles 
sur le Volume disque pour la sauvegarde des donnees. 

$49 Le Catalogue principal du Volume est plein. Seulement 51 
fichiers peuvent etre ranges dans le Catalogue principal. 

$4A Le format du fichier specif i^ est inconnu ou incompatible avec 
la version du syst^me d'exploitation utilise. 

$4B Le type de fichier n'est pas valide ou n'est pas reconnu. 

$4C La fin du fichier (EOF) a et^ atteinte durant une operation de 
lecture. 

$4D La valeur MARK specifiee est sup^rieure k EOF. 

$4E Le syst^me d'exploitation ne peut pas acceder au fichier. Cette 
erreur arrive quand une operation mterdite par le code d'acc^s 
fichier a ete demand^. Le code d'acc^s fichier contrdle les 
commandes Rename, Destrdy, Read, et Write. L' erreur peut 
aussi survenir si on tente de d^truire un sous-catalogue qui 
n'est pas vide. 

$4F La taill§ du buff§F d@ da§§§ 1 d§ §8Fti§ d§ G%/0% §§t tfep 

petite. 

$50 Commande non valide parce que le fichier est ouvert. Les 
commandes Open, Rename, et Destroy ne s'appliquent qu'aux 
fichiers fermes. 

$51 Le nombre de fichiers au catalogue est different du nombre de 
fichiers indique dans I'entete du catalogue. 

$52 Volume Disque non ProDos. La structure de catalogue est 
inconsistante avec ProDos. 

$53 Param^tre non valide. Un param^tre est invalide quand il est 
hors des limites fixees par le syst^me d'exploitation. 

$54 Plus de memoire disponible. 

$55 Cette erreur survient si 8 fichiers sur 8 Devices diff^rents ont 
et4 ouverts, et que la commande ONLINE est demand^ sur 
un Device n'ayant pas de fichiers ouverts. 

$56 L'adresse d'un buffer n'est pas valide car il y a un conflit en 
memoire dans les zones declares utilisees dans la Bit Map de 
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ProDos 8, ou parce que le buffer ne debute par sur un saut de 
^ page memoire. 

$57 Volume disque en ligne ayant le meme nom de catalogue 
principal. 

$58 Le Device specifie n'est pas organist en blocs. 

$59 Le niveau de priori te passee par la commande GS/OS SetLe- 
vel est hors des limites acceptees par le syst^me. 

$5 A La Bit Map du Volume indique qu'un bloc ayant un num^ro 
superieur au nombre de blocs disponibles sur le Volume est 
declare libre._L3. Bit Map du volume a et6 endommag^e. 

$53 Changement illegal de Pathname. Cette erreur survient si les 
Pathnames specifies dans la commande ChangePath de GS/ 
OS font reference k 2 Volumes differents. On ne peut deplacer 
des fichiers seulement entre les catalogues d'un meme vo- 
lume. 

$5C Le fichier specifie n'est pas un fichier syst^me executable. 
GS/OS donne cette erreur si on tente d'utiliser la commande 
Quit pour passer le controle k un fichier qui n'est pas un fichier 
syst^me GS/OS (S16 ou $B3; EXE ou $B5), ou un fichier 
syst^me ProDos 8 (SYS ou $FF). 

$5D Le syst^me d'exploitation specifie n'est pas disponible. 
GS/OS retourne cette erreur quand on tente d'executer un 
programme syst^me ProDos 8 quand le fichier / SYSTEM /P8 
ne se trouve pas sur le volume syst^me. 

$5E Le Volume /RAM ne peut pas etre supprime. 

$5F La pile des adresses de retour des Quit est saturee. GS/OS 
retourne cette erreur quand on tente de pousser un autre ID 
d'un programme sur cette pile quand celle-ci est pleine. 

$61 Fin de Catalogue. Cette erreur ne peut etre retournee que par 
la commande GS/OS GetDirEntry. 

$62 Numero de classe non valide. 

$64 ID invalide pour un fichier Syst^me. 

$65 Operation FST invalide. 
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5.2.4 Buffers de sortie de classe et de classe 1 

Meme si un pointeur sur une chaine ou sur un buffer est place dans 
une Table de Param^tres, ce n'est jamais ProDos 8 ou Gb/OS qui a 
place ce pointeur. Le syst^me d'exploitation se contente de retour- 
ner des donnees dans le buffer points par ce pointeur. 

•Sous ProDos 8, c'est I'application qui doit s'allouer un buffer 
d'une taille convenable et qui doit passer le pointeur sur I'adresse 
de debut de ce^buffer dans la Table des Param^tres. 

Si vous ne creez pas un buffer d'une taille suffisante, les datas qui 
suivent ce buffer seront ecrasees. Un buffer de ce genre est appele 
un buffer de sortie de classe 0. 

•GS/OS utilise des buffers de sortie de classe 1 pour eviter I'^cra- 
sement de datas pour le cas ou le buffer de sortie n'aurait pas une 
taille suffisante. Un buffer de classe 1 debute par un mot (2 octets) 
mdiquant le nombre d'octets de ce buffer (en y incluant ce mot). 

Quand on appelle une commande qui utilise un buffer de sortie de 
classe 1, GS/OS verifie le mot de longueur plac6 en debut du buffer 
pour voir si la taille du buffer est suffisamment importante. Si cette 
taille est trop petite, la commande retourne un code d'erreur $4F 
(buffer trop petit) et retourne la taille du buffer necessaire dans le 
mot suivant le mot de longueur du buffer. Si la taille du buffer est 
suffisante, la commande envoi les datas dans le buffer juste apr^s le 
mot contenant la longueur du buffer. 



5.2.4 Les commandes GS/OS - ProDos 8 par ordre alphabetique 

ALLOC_INTERRUPT 

GS/OS : n'existe pas 

ProDos 8 :$40 

Fonction : Placer I'adresse d'une sous-routine de gestion d'inter- 
ruption dans la table des vecteurs d' interruption de ProDos 8. La 
table des vecteurs d' interruption peut contenir jusqu'^l 4 sous- 
routines. 
Sous GS/OS on utilise la commande Bindlnt. 
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Table des Param&tres 



OFFSET NOM 



+0 
+1 

+2^+3 



num_parms 
int_num 

int code 



I/O DESCRIPTION 

I Nombre de param^tres (2) 

Numero de reference du Han- 
dler d'interruption 

1 Pointeur sur le Handler d'inter- 
ruption 



Description des param^tres : 

num_parms : Nombre de param^tres dans la Table des 
Param^tres ProDos 8 (toujours 2). 

int_num : C'est le numero de reference que ProDos 8 attribue k la 
sous-routine de gestion d'interruption. II faut utiliser ce nombre 
quand onutilise la commande DEALLOCJNTERRUPT pour reti- 
rer cette sous-routine. 

int_code : Pointeur sur la sous-routine de prise en char^ede I'in- 
terruption. ProDos 8 passe le controle k cette sous-routine ouand 
une interruption est aemandee. La sous-routine de prise en cnarge 
de interruption doit debuter par une instruction CLD. 

II est important d'installer la sous-routine de prise en charge de 
r interruption avant de permettre au peripherique de generer une 
interruption. Dans le cas contraire, le syst^me plantera si une inter- 
ruption est demandee avant I'installation de la sous-routine desti- 
nee h la prendre en charge. 

Codes d'erreur possibles : 

$25 : La Table des Vecteurs d'interruption est pleine. La solution 
consiste k enlever une sous-routine de prise en charge 
d'interruption en utilisant la commande DEALLOCJNTERRUPT, 
puis de re-essayer. 
Exemple de programme : 

Voici comment installer une sous-routine ProDos 8 de prise en 
charge d'interruption qui a ete chargee en memoire k I'adresse $300. 



JSR 


MLI 




DFB 


$40 


; ALLOC INTERRUPT 


DA 


PARMTBL 


;ADRESSE DE LA TABLE DES PARAMETRES 


BCS 


ERROR 


;BRANCHEMENT EN CAS D'ERREUR 


RTS 




copyright Toolbox 1990 323 



PARMTBL DFB 2 ;NOMBRE DE PARAMETRES 

DS 1 ;LENUMERODE REFERENCE REVIENDRA 

;ICI 
DA $300 ;ADRESSE DE LA SOUS-ROUTINE D'lNTER- 

;RUPTION 

Votre application devra sauvegarder int_num pour pou voir utiliser 
par la suite la commande DEALLCX:_INTERRUPt: 



Begin Session 
GS/OS : $201D 

Fonction : Indique k GS/OS de differer toutes les operations d'^cri- 

ture qui portent sur la mise h jour de la Bit Map et des blocs de 

catalogue. 

II n'y a pas de commande equivalente en ProDos 8. 

Table des Paramdtres : 

OFFSET NOM I/O DESCRIPTION 

+0^+1 pcount I Nombre de param^tres (0) 

Description des param^tres : 

pcount : C'est le nombre de param^tres dans la Table des param^ 
tr^s. Cette valeur est toujours 0. 

Codes d'erreur possibles : 

aucun 

Commentaires : Les sessions d'ecriture differ^ sont utiles quand 
une application doit transferer rapidement un groupe de fichiers 
d'un disque sur un autre. Si on n'utilise pas une session d'ecriture 
differee, les operations de copie seront ralenties parce que la t§te de 
Lecture / Ecriture doit balayer toute la surface du disque pour 
acc^der k la Bit Map et aux blocs de Catalogue avant chaque 
transfert de fichier. A la fin d'une operation de copie de ce type, il 
taut utiliser la commande EndSession pour ^crire sur le disque les 
blocs restants. A chaque commande BeginSession doit correspon- 
dre une commande EndSession. 

ProDos 8 : n'existe pas 
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Bindint 

GS/OS : $2031 

Fonction : Permet d'attribuer une sous-routine de gestion d' inter- 
ruption sous GS/OS vers une source particuli&re d'interruption. 
Sous ProDos 8, on utilise la commande ALLOCJNTERRUPT. 



Table des Param^tres 



OFFSET 



NOM 



I/O 



+0^+1 


pcount 


I 


+2^+3 


int num 


O 


+4^+5 


vrn 


I 


+6k+9 


int code 


I 



DESCRIPTION 

Nombre de param&tres (3) 
Numero de reference de I'interruption 
Numero de reference du vecteur 
Pointeur sur le Handler d'interruption 

Description des param^tres : 

pcount : C'est le nombre de param^tres dans la Table de Para- 
m^tres GS/OS. La valeur est toujours 3. 

int_num : C'est le numero de reference que GS/OS attribue h la 
sous-routine de gestion d'interruption. On utilise ce numero de re- 
ference quand on veut enlever la sous-routine avec la commande 
UnBindlnt. 

vrn : C'est le numero de reference qui identifie le type d'interrup- 
tion syst^me auquel est attribue le Handler d'interruption. 



I 



$0008 

$0009 

$000A 

$000B 

$000C 

$000D 

$000E 

$000F 

$0010 

$0011 

$0012 

$0013 

$0014 

$0015 

$0016 

$0017 



Appletalk (SCO 

Ports S6rie (SCC) 

Scan Line 

Fin de Waveform (Ensoniq) 

VBL (Vertical Blanking Signal) 

Souris (Mouvement ou click) 

Timer 1/4 de seconde 

Clavier 

Octet de r^ponse ADB pret 

SRQ (ADB Service Request) 

Accessoire de bureau demande 

Interruption Buffer clavier 

Interruption Micro Clavier 

Timer 1 seconde 

VGC (Video Graphics Controller) 

(Externe) 

Autre source d'interruption 
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sec = Serial Communications Controller 
ADB = Apple Desktop Bus 

int_code : Pointeur sur le debut de la routine 
de gestion d'interruption. 

Codes d'erreur possibles : 

$25 : La table des vecteurs d'interruption est remplie. Utilisez la 
commande Unbindint puis recommencez. 

autres codes possibles : $04, $07, $53. 

ProDos 8 : n'existe pas 



ChangePath 
GS/OS : $2004 

Fonction : Permet de renommer un fichier ou un Volume disque ou 
de deplacer un fichier d'un sous-catalogue h un autre sur le meme 
Volume Disque. Vous pouvez modifier le path de tout fichier ferme 
dont le bit de code d'acc^s est k 1. Sous ProDos 8, utilisez la 
commande RENAME pour renommer un fichier ou un Volume 
Disque. II n'y a pas de commande ProDos 8 pour deplacer un fichier 
d'un sous-catalogue h un autre. 

Table des Param^tres : 

OFFSET NOM I/O DESCRIPTION 

+0^+1 pcount I Nombre de Paramfetres (2) 

+2 4 +5 pathname I Pointeur sur le Pathname 

+6 k +9 new_pathname I Pointeur sur le niveau Pathname 

Description des param^tres : 

pcount : Nombre de param^tres dans la Table de Param^tres GS/ 
OS. Ce nombre est toujours 2. 

pathname : Pointeur de classe 1 pointant sur le Pathname courant 
du fichier qui doit etre modifie. Si ce Pathname n'est pas precede 
par un separateur (/ ou :), le syst^me d'exploitation ajoute automa- 
tiquement le prefixe par defaut (le pr^fixe 0/) pour cr6er le path- 
name complet. 
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new_pathname -.Pointeur de classe 1 pointant sur le nouveau Path- 
name du fichier qui va etre modifie. Si ce Pathname n'est pas 
precede par un separateur (/ ou :), le syst^me d'exploitation ajoute 
automatiquement le^refixe par defaut (le prefixe 0/) pour creer 
le pathname complet. 

Codes d'erreur possibles : 

$2B : Le Volume Disque est protege en ecriture. 

$40 : Le Pathname contient des caract^res non valides, ou un Path- 
name complet n'est pas specifie (et il n'y a pas de prefixe par 
defaut defmi). 

$44 : Un Catalogue dans un Pathname n'a pas ete trouve. 

$45 : Le Catalogue principal n'a pas ete trouv6. 

$46 : Le fichier n'a pas ete trouve. 

$47 : Le nouveau Pathname indique existe dej^. 

$4E : Le syst^me ne peut pas acceder au fichier. Son code d'acc^s ne 
lui permet pas d'etre renomme. Utilisez la commande SetFi- 
lelnfo pour modifier ce code d'acc^s. 

$50 : Le fichier est ouvert. Cette commande ne fonctionne qu'avec 
des fichiers fermes. 

$5B : Les deux Pathnames indiquent des Volumes differents. 

autres codes d'erreur possibles : $07, $27, $4 A, $4B, $52, $57, $58. 

Exemple de programme : 

Supnosez que vous vouliez deplacer un fichier appele ACCES- 
SOlkE d'un sous-catalogue appele CDA.NDA du disque de Boot 
vers le Catalogue DESK.ACCS du disk de boot. 



JSL $E100A8 

DA $2004 

ADRL CP_Parms 

BCS Error 



CP ParmsDA 



$2 



;Appel GS/OS 
;Commande ChangePath 
;Adresse Table des Param^tres 
;En cas d'erreur 

;Nombre de Param^tres 
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ADRL NomCourant 
ADRL NouveauNom 

NomCourant ASC «*:CDA.NDA:ACCESSOIRE» 
NouveauNon^ASC «*:SYSTEM:DESK.ACCS : ACCESSOIRE» 

Quand les deux Pathnames specifies decrivent le meme fichier dans 
le meme sous-catalogue, la commande ChangePath est equivalente 
h la commande ProDos 8 RENAME. 

ProDos 8 : n'existe pas 

ClearBackup 

GS/OS : $200B 

Fonction : Met ^ le bit Backup dans le code d'acc^s d'un fichier. 

Table des Param^tres : 

OFFSET NOM I/O DESCRIPTION 

+0 k +1 pcount I Nombre de Param&tres (1) 

+2 k +5 pathname I Pointeur sur le Pathname 

'■ Description des Param^tres : 

pcount :Nombre de param^tres dans la Table des Param&tres 
GS/OS; toujours 1. 

pathname :Pointeur GS/OS de classe 1 pointant sur le Pathname 
courant du fichier k utiliser. Si ce Pathname n'est pas precede par 
un separateur (/ ou :), le syst^me d'exploitation ajoute automati- 
quement le prefixe par defaut (le prefixe 0/) pour creer le path- 
name complet. 

Codes d'erreur possibles : 

$40 : Le Pathname contient des caractdres non valides, ou un Path 
name complet n'est pas specifie (et il n'y a pas de prefixe par 
defaut defini). 

$44 : Un Catalogue dans le Pathname n'a pas 6te trouv6. 

$45 : Le Catalogue principal n'a pas §t6 trouv6. 
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$46 : Le fichier n'a pas ete trouve. 

autres cod^s d'erreur possibles : $07, $4A, $52, $58. 

Exemple de programme : 

Un programme de copie de fichier doit seulement copier les f ichiers 
qui ont ete modifie depuis la derni^re operation de copie. Le pro- 
gramme de copie doit verifier le bit de Backup de chacun des 
fichiers pour determiner s'ils doivent etre copies ou non; la copie se 
fait si le bit de Backup est ^ 1. GS/OS et ProDos 8 mettent automa- 
tiquement ce bit k 1 apr^s chaque operation d'ecriture concernant 
un fichier. line fois la copie terminee, le programme de copie doit 
remettre ^ le bit de Backup en appelant la commande ClearBac- 
kup. 



JSL 


$E100A8 


;Appel GS/OS 

;Code de la commande Clear 


DA 


$200B 






;Backup 


ADRL 


ParmTbl 


;Adresse de la Table de Para 
;m^tres 


BCS 


Error 


;En cas d'erreur 


DA 


$1 


;Nombre de Param^tres 


ADRL 


Pathname 


;Adresse du Pathname 


ASC 


«/DISK/NEW.nLE» 


;Fichier cible 



ProDos 8 : n'existe pas 

Close 

GS/OS : $2014 

Fonction : Permet de fermer un fichier qui a ete ouvert. Le syst^me 
d' exploitation ecrit le contenu du buffer attribu^ h ce fichier sur le 
Volume et met ^Jour I'Entree au Catalogue de ce fichier. Ensuite, le 
syst^me d'exploitation lib^re la memoire utilisee par le buffer de ce 
fichier. 
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Table des Param^tres 



OFFSET NOM 



+Ok+l 

+2^+3 



pcour 
ref nr 



I/O DESCRIPTION 

I Nombre de param^tres 

I Numero de Reference du fichier 



CLOSE 

ProDos 8 : $CC 

Fonction : meme chose que pour GS/OS 



Table des Param^tres 



OFFSET 

+0 
+1 



NOM 



num_parms 
ref num 



I/O DESCRIPTION 

I Nombre de param&tres (1 ) 

I Numero de Reference du fichier 



Description des Param^tres : 

pcount / num_parms : Nombre de param^tres dans la Table des 
Param^tres (1). 

ref_num : Numero de Reference que le syst^me d'exploitation a 
attribue au fichier quand celui-ci a et^ ouvert. 

Si on fixe ref_num h 0, tous les fichiers ouverts ayant le meme 
niveau de priorite que le fichier syst^me, ou ayant un niveau de 
priorite superieur au fichier syst^me sont fermes. Sous ProDos 8, 
pour fixer la valeur du niveau de priorite d'un fichier, on stocke 
cette valeur k I'adresse LEVEL ($BF94). Sous GS/OS, on utilise la 
commande SetLevel. 

Codes d'erreur possibles : 

$2B : Le Volume est proteg^ en ecriture. 

$43 : Le Numero de Reference du fichier n'est pas valide. Vous 
utilisez tr^s certainement le numero de Reference d'un fichier 
ayant dej^ ete ferme. 

autres codes d'erreur possibles : $04, $07, $27, $5 A. 
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Exemple de programme 



Pour fermer tous les fichiers ouverts ayant un niveau de priority 
superieur ou egal ^ 1, on utilise la commande SetLevel et la com- 
mande Close avec ref_num = 0. Void comment proceder sous GS/ 
OS. 



;Commande SetLevel 1 

;En cas d'erreur 

;Commande Close 

;En cas d'erreur 

;Nombre de Param^tres 
;Nouveau Niveau de priorite 
;pour le fichier 

;Nombre de Param^tres 

;Num6ro de Reference 

;= 0, Fermer tous les fichiers 





JSL 


$E100A8 




DA 


$201 A 




ADRL 


ParmTbll 




BCS 


Error 




JSL 


$E100A8 




DA 


$2014 




ADRL 


ParmTbl2 




BCS 


Error 


ParmTbll 


DA 


$1 




DA 


$1 


ParmTbl2 


DA 


$1 




DA 


$0 



;■'! 



I 



Create 

GS/OS : $2001 

Fonction : Utilisee pour creer un nouveau fichier. Le syst^me d'ex- 
ploitation realise cette fonction en plagant une nouvelle Entree dans 
le Catalogue specifie. 

Table des Param^tres : 



OFFSET NOM I/O DESCRIPTION 

Nombre de param&tres (7) 

Pointeur sur I'adresse du Pathname 

Code d'Acc&s 

Code du Type de Fichier 

Code du Type Auxiliaire de Fichier 

Code du Type d'Enregistrement 

Taille prevue du segment de donnees 

Taille prevue du segment de ressources 



+0 4+1 
+2 4+5 
+6 4+7 


pcount I 
pathname I 
access I 


+8 4+9 
+10 4+13 
+14 4+15 
+16 4+19 


file_type I 
aux_type I 
storage_type I 
eof I 


+20 4 +23 


resource eof I 
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+0 

+1^+2 


num_parms I 
pathname I 


+3 


access I 


+4 
+5^+6 


file_type I 
aux_type I 


+7 
+8^+9 


storage_type I 
create_date I 


+10^+11 


create time I 



Create 

ProDos 8 : $C0 

Fonction : meme chose que GS/OS 
Table des ParamMres : 

OFFSET NOM I/O DESCRIPTION 

Nombre de param&tres (7) 

Pointeur sur I'Adresse du Pathname 

Code d'Acc^s 

Code du Type de Fichier 

Code du Type Auxiliaire de Fichier 

Code du Type d'Enregistrement 

Date de Creation 

Heure de Creation 

Description des Param^tres : 

P count / num_parms : Nombre de param^tres dans la Table des 
aram^tres (7). 

pathname : Un pointeur sur un buffer de classe (ProDos 8) ou de 
classe 1 (GS/OS) sur I'adresse du Pathname du fichier qui va §tre 
cree. Si le Pathname specific n'est pas precede par un separateur (/ 
pour ProDos 8; / ou : pour GS/OS), le syst^me d'exploitation 
ajoute automatiquement le nom du prefixe par defaut (sous GS/OS 
c'est le prefixe 0/) pour creer le Pathname en tier. 

access :Voir la partie consacree k I'Organisation des Fichiers sur 
Disque pour une explication detaillee du Code d'Acc^s. 

file_type : Code indiquant le Type du Fichier k creer. Ces codes ont 
dej^ ete expli cites. 

aux_type : Code indiquant le Type Auxiliaire du Fichier k creer. La 
signification de ce code depend au Type de Fichier. Pour les fichiers 
SYS, BIN, BAS, et VAR, le Type Auxiliaire de Fichier contient 
I'adresse de chargement par defaut de ce fichier; pour les fichiers 
TXT, ce code est la longueur de chaque enregistrement du fichier 
texte. 

storage_type : Ce code indique la fagon dont le syst^me d'exploita- 
tion a sauvegarde le fichier sur le volume disque; 
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c'est le Type d'Enregistrement du fichier : 

$00-$03 Fichier standard 

$05 Fichier de type ^tendu 

$0D Fichier Sous-Catalogue 

On ne peut pas changer ce code una fois que le fichier est cr6^. 
create_date : Date de creation du fichier (Annee, mois, jour). Si ces 
octets sont ^ la Date par defaut est utilisee. 
create_time : Heure de creation (Heure, Minute). Si ces octets sont 
h I'Heure par defaut est utilisee. 

eof : Si le fichier cree est un fichier standard, ce champ indique la 
taille prevue pour ce fichier (en nombre d' octets). Le syst^me d' ex- 
ploitation prevoit un nombre suffisant de blocs pour sauvegarder 
ce fichier. 

Si le fichier cree est un fichier de type 6tendu, ce champ indique 
la taille prevue du segment de datas (en nombre d'octets). 

Si le fichier cree est un fichier Sous-Catalogue, ce champ indique 
le nombre d'Entrees prevues dans ce Sous-Catalogue. 

resource_eof : Si le fichier cree est de type etendu, ce champ indi- 
que la taille prevue du segment de ressource (en nombre d'octets). 

Codes d'erreur possibles : 

$2B : Le Volume Disque est protege en ecriture. 

$40 : Le Pathname contient des caract^res non valides, ou un Path 
name complet n'est pas specifie (et il n'y a pas de pr^fixe par 
defaut defini). 

$44 : Un Catalogue dans un Pathname n'a pas ete trouve. 

$45 : Le Catalogue principal n'a pas ete trouve. 

$47 : Le nouveau Pathname indiqu6 existe dej^. 

$48 : Le Volume Disque est plein. 

$49 : Le Catalogue principal est plein. Seuls 51 fichiers peuvent etre 
sauvegardes dans \e catalogue principal. 
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$4B : Code du Type d'Enregistrement non valide. 

autres codes d'erreur possibles : $04, $07, $10, $27, $52, $53, $58. 
Exemple de programme : 

Voici une petite routine sous GS/OS permettant de creer un fichier 
Texte (TXT); le nom du fichier TXT est ALLIANCE; le Pathname 
complet est : GSrALLIANCE. 



JSL $E100A8 

DA $2001 

Adrl ParmTbl 

BCS Error 

ParmTbl DA $5 

ADRL Pathname 
DA $E3 
DA $04 
ADRL $0 
DA $01 



;Commande Create 
;Table des Param^tres 
;En cas d'erreur 

;Nombre de Param^tres 
;Adresse du Pathname du fichier h cr^r 
;Code d' Acc^s standard (non verrouille) 
;Type de Fichier = $04 = Fichier TXT 
;Type Auxiliaire (0 = sequentiel) 
;Type d'Enregistrement = 1 (standard) 



Pathname ASC «:GS:ALLIANCE» 

DControl 

GS/OS : $202E 

Fonction : Permet de passer les commandes k un Device GS/OS. 

Table des Param^tres : 



OFFSET 

+0^+1 
+2^+3 
+4^+5 
+6^+9 
+10^+13 
+14^+17 



NOM I/O 



DESCRIPTION 

Nombre de param&tres (5) 
Numero de Reference du Device 
Code de controle demande 
Pointeur sur la liste de Contr61e 
Taille de la liste de Controle 



pcount 

dev_num 

control_code 

control_list 

request_count 

transfer count O Nombre d'octets transferes 



Description des Param^tres : 

pcount : Nombre de param^tres. 

dev num iNumero de Reference du Device. 
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control_code : C'est un code qui indique I'op^ration de contrdle k 
realiser : 

$0000 reset device 

$0001 formatage disque device 

$0002 ejection disque device 

$0003 reglages param^tres de configuration 

$0004 r^glage mode attente / pas d attente 

$0005 reglage des options de formatage 

$0006 attribution de la partition 

$0007 armement du signal 

$0008 de-armement du signal 

$0009 reglage carte de partition 

$000A-$7FFF reserve 

$8000-$FFFF operations sp6cifiques sur le Device 

control_list : Pointeur sur un buffer contenant des donnees suppl6- 
mentaires dont GS/OS peut avoir besoin pour realiser une opera- 
tion de controle. 

request_count : Taille du buffer de la Liste de Controle. 

transfer_count : Nombre d'octets retourn^s dans le buffer de la Liste 
de Controle. Retournes par le syst^me d'exploitation. 

Codes d'erreur possibles : 

$11 : Le numero de Reference du Device n'est pas valide. 

$53 : Le paramtoe est hors des limites admises. 

autre code d'erreur possible : $07 

Exemple de programme : 

La seule commande de controle que vous serez tr^s vraisemblable- 
ment amene k utiliser est la commande d' ejection d'un disque. 
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JSR $E100A8 

DA $202E ;DControl 

Adrl ParmTbl ;Adresse Table des Param&tres 

BCS ERROR ;En cas d'erreur 

ParmTbl DA $5 ;Nombre de param^tres 

DA $2 ;Numero de Device 

DA $2 ;Code de Controle (2 = Eject) 

Adrl Ctrl_List ;Adresse de la Liste de Controle 

Adrl $0 

DS $4 

CtrLList DS $4 ;Liste de Controle vide 

On peut determiner si un disque est ejectable en utilisant la com- 
mande DInfo et en examinant le bit 2 du mot des caracteristiques; si 
le bit est ^ 1, le disque est ejectable. Pour avoir des informations 
completes sur les commandes de controle, consultez GS/OS Refe- 
rence Volume 2. 

ProDos 8 : n'existe pas 

DEALLOCJNTERRUPT 

GS/OS : n'existe pas 

ProDos 8 : $41 

Fonction : Permet d'enlever I'adresse d'une sous-routine de gestion 
d'interruption dans la table des vecteurs d' interruption de ProDos 
8. Sous GS/OS, on utilise la commande UnBindlnt. 

Table des Param^tres : 

OFFSET NOM I/O DESCRIPTION 

+0 num_parms I Nombredeparam&tres (1) 

+1 int_num I Numero de reference du Handler d'interruption 

Description des Param^tres : 

num_parms : Nombre de param^tres 

int_num : Numero d'identification du Handler d'interruption. Pro- 
Dos 8 attribue ce numero lorsque le Handler est installe avec la 
commande ALLOC_INTERRlJPT. 
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Important : Ne pas enlever la sous-routine de gestion d'interrup- 
tion avant que I'application est indiquee au penpherique d'arreter 
de generer des interruptions. 

Codes d'erreur possibles : 

$53 : Le param^tre int_num n'estpas valide. II faut utiliser le nume- 
ro que la commande ALLOC_INTERRUPT a retourne quand le 
Handler d' Interruption a ete install^. 

autre erreur possible : $04 

Exemple de programme : 

Void comment enlever de la Table des Vecteurs d'interruption une 
sous-routine de gestion d'interruption dont le numero de R6f6rence 
estl. 

JSL MLI 

DFB $41 ;DEALLOC_INTERRUPT 

DA PARMTBL ;Adresse de la Table des Param^tres 

BCS ERROR ;En cas d'erreur 
RTS 

PARMTBL DFB $1 ;Nombre de paramfetres 

DFB $1 ;Num6ro de code de interruption 



Destroy 

GS/OS : $2002 

Fonction : Permet d'enlever un fichier d'un volume disque. Quand 
on detruit un fichier, le syst^me d'exploitation lib^re tous les blocs 
que le fichier utilisait et met k zero I'octet de longueur dans 1' entree 
catalogue qui correspond h ce fichier. On ne peut detruire les fi- 
chiers dont le bit de code d'acc^s de destruction est k 1; les fichiers 
sous-catalogues doivent etre vides avant de pouvoir etre detruits. 
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Table de Param^tres : 

OFFSET NOM I/O DESCRIPTION 

+0^+1 pcount I Nombredeparam&tresd) 

+2 k +5 pathname I Pointeur sur I'Adresse du Pathname 

DESTROY 

ProDos 8 : $C1 

Fonction : meme chose que pour GS/OS 

Table de Param^tres : 

OFFSET NOM I/O DESCRIPTION 

+0^+1 num_parms I Nombredeparam&tresd) 

+2 d +5 pathname I Pointeur sur I'Adresse du Pathname 

Description des Param^tres : 

pcount / num_parnis : Nombre de param^tres dans la Table des 
param^tres. 

gathname : Un pointeur de classe (ProDos 8) ou de classe 1 (GS/ 
'S) sur I'adresse du Pathname du fichier qui va etre detruit. Si le 
Pathname specific n'est pas precede par un separateur (/ pour 
ProDos 8; / ou : pour GS/OS), le syst^me d'exploitation ajoute 
automatiquement le nom du prefixe par d6faut (sous GS/OS c'est 
le prefixe 0/) pour cr^r le Pathname en tier. 

Si le Pathname decrit un fichier etendu, les deux segments sont 
detruits. 

Codes d'erreur possibles : 

$2B : Le Volume Disque est prot^g^ en Venture. 

$40 : Le Pathname contient des caractlres non valides^ ou un Path 
name complet n'est pas sp^cifi^ (et il n'y a pas de prefixe par 
defaut defmi). 

$44 : Un Catalogue dans un Pathname n'a pas ete trouve. 
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$45 : Le Catalogue principal n'a pas ^t4 trouv4. 

$46 : Le fichier n'a pas ete trouve. 

$4E : Le syst^me ne peut pas acc^der au fichier. 

$50 : Le fichier est ouvert; on ne peut d^truire que les f ichiers f erm^s. 
autres codes d'erreur possibles : $04, $07, $10, $27, $4A, $52, $58. 
Exemple de programme : 

Prenons le cas dans lequel le Pr^fixe 0/ est /DEMO/NUCLEUS. 
Pour detruire un fichier ayant le pathname entier /DEMO/NU- 
CLEUS/PROG, on peut utiliser la sous-routine GS/OS suivante. 

JSL $E100A8 

DA $2002 ;Destroy 

Adrl ParmTbl ;Table des Param^tres 

BCS Error ;En cas d'erreur 
RTS 

ParmTbl DA $1 ;Nombre de param^tres 

Adrl Pathname ;Adresse du Pathname 

Pathname ASC«PROG» 

Un fichier de type etendu ne peut etre d^truit que par la commande 
Destroy de GS/OS. 



DInfo 

GS/OS : $202C 

Fonction : Permet d' avoir des informations sur le Device connecte 
au syst^me. 
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Table de Paramtoes : 



OFFSET 



NOM 



I/O 



DESCRIPTION 



+oa+i 


pcount 


I 


+2 4+3 


dev_num 


I 


+4k+7 


dev_name 


O 


+8 4+9 


characteristic 


O 


+10 4+13 


total_bIokcs 


O 


+14 4+15 


slot_num 


O 


+16 4+17 


unit_num 


O 


+18 4+19 


version 


O 


+20 4 +21 


device_ID_num 


O 


+22 4 +23 


head_link 


O 


+24 4 +25 


forward_link 


O 



Nombre de param&tres (10) 

Numero de Reference du Device 

Pointeur sur le nom du Device 

Caracteristiques du Device 

Capacite du volume en nombre de Blocs 

Numero de Slot du Device 

Numero d'Unite du Device 

Numero de version du driver duDevice 

Numero ID du Device 

Premier Device en relation 

Prochain Device en relation 



Description des Param^tres : 

pcount : Nombre de param^tres dans la Table des Param^tres. La 
valeur minimum est 2; la valeur maximum est 10. 
dev_num : Numero de Reference du Device. 

dev_name : Pointeur de classe 1 sur un buffer de sortie dans lequel 
GS/OS a retourne le nom du Device. Un nom de Device peut avoir 
iusqu'^ 31 caract^res de longueur; il faut done fixer la taille de ce 
Duffer k 35 octets. 

characteristics : Chacun des bits de ce mot donne les caracteristiques 
du Device. 

bit 15 : 1 = le Device est un Ramdisk ou un Romdisk 

bit 14 : 1 = le driver du Device a ete genere 

bit 13 : reserve 

bit 12 : 1 = le Device est actif 

bit 1 1 : reserve 

bit 10 : reserve 

bit 9 : Vitesse du Device (poids fort) 

bit 8 : Vitesse du Device (poids faible) 

bit 7 : 1 = Device organise en Blocks 

bit 6 : 1 = Ecriture autorisee 

bit 5 : 1 = Lecture autorisee 

bit 4 : reserve 

bit 3 : 1 = Formata^e autorisee 

bit 2 : 1 = Device ejectable 

bit 1 : reserve 

bit : reserve 
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Les bits 9 et 8 indiquent la vitesse h. laquelle le Device peut 
fonctionner : 

00 : Device 1 MHz 

01 : Device 2.6 MHz 

10 : Device > 2.6 MHz 

11 : La Vitesse ne joue pas sur ce Device 

total_blocks : Pour un Device organise en blocs, c'est la capacite du 
volume en nombre de blocs. Pour un Device Character, ce chan\p 
reste h 0. 

slot_num : Numero de Slot du Device. 

unit_num : Nun\ero d' unite du Device utilise par le SmartPort. 

version : Numero de version du driver du Device 

bits 15-12 : Numero de version principale 

bits 11-8 : Premier numero de version accessoire 

bits 7- 4 : Deuxi^me numero de version accessoire 

bits 3- : Type de version 

$0 = version finale 

$A = version alpha 

$B = version beta 

$E = version experimentale 

$F =version finale non achevee 
Par exemple, une version beta 2.12 serait codee par le mot $212B. 

device_ID_num : numero de code qui identifie un type de Device : 



1 



$0000 

$0001 

$0002 

$0003 

$0004 

$0005 

$0006 

$0007 

$0008 

$0009 

$000A 

$000B 

$000C 

$000D 

$000E 



lecteur de disques 5.25 
disque dur Profile (5 Mo) 
disque dur Profile (10 Mo) 
lecteur de discjues 3.5 
device SCSI generique 
disque dur SCSI 
lecteur de bandes SCSI 
lecteur CD-Rom SCSI 
imprimante SCSI 
modem serie 
console 

imprimante s^rie 
LaserWriter serie 
LaserWriter AppleTalk 
Ram disque 
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$000F 

$0010 

$0011 

$0012 

$0013 

$0014 

$0015 

$0016 

$0017 

$0018 

$0019 

$001A 

$001 B 

$001C 

$001D 

$001E 

$001F 



Rom disque 

fichier serveur 

telephone IBX 

device ADB 

disque dur ^enerique 

lecteur de disques g6n6rique 

lecteur de bandes generique 

device Caract^re g^n^rique 

lecteur de disques de type MFM 

device generique reseau AppleTalk 

device SCSI k acc^s s^quentiel 

scanner SCSI 

scanner non SCSI 

LaserWriter SCSI 

driver AppleTalk principal 

driver fichier de service Appletalk 

driver AppleTalk RPM 



head_link : Numero de device indiauant quelle est la premiere 
entree dans une liste de num^ros de device. Les devices de la liste 
sont ceux qui pour un volume ont une partition distincte. Si 
head_link = 0, ii n'y a pas de lien. 

forward_link : Numero de device indiquant quelle est la prochaine 
entree dans une liste de numeros de device. Les devices de la liste 
sont ceux qui pour un volume ont une partition distincte. Si 
forward_link = 0, il n'y a pas de lien. 

Codes d'erreur possibles : 

$11 : Numero de Reference du Device non valide. 

autre codes d'erreur possible : $07 

Exemple de programme : 

On peut utiliser la commande DInfo pour connaitre tous les noms 
de Devices connectes au syst^me. Pour cela, il faut faire une s^rie 
d'appels h DInfo en incrementant h chaque appel dev_num de 1, 
ius^u'^ ce que DInfo retourne un code d'erreur de $1 1 (Numero de 
Reference du Device non valide). Le premier dev_num h passer k 
DInfo doit etre 1 puisque c'est le numero de Device que GS/OS 
attribue au premier Device qu'il trouve au moment du cnargement. 
II ne faut pas oublier que le nombre de Devices actifs connectes au 
syst^me peut chancer pendant I'ex^cution du programme. Par 
exemple, dans un reseau, des Volumes peuvent se connecter ou se 
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deconnecter h tout moment. Ainsi, quand on veut constituer une 
liste de Devices connectes au syst^me, il est preferable de constituer 
cette liste k chacjue fois que Ton en a besoin plutot que de la 
constituer une fois pour toute au tout d^but du programme. 

Voici une partie du code pour realiser ce travail : 

LDA #1 

STA DevNum 



Loop JSL $E100A8 

DA $202C 

Adrl ParmTbl 

BCS Exit 

Affichage 



;DInfo 

;Table de Param^tres 

;En cas d'erreur on sort 



BRA 


Loop 


Exit RTS 




ParmTbl DA 


10 


DevNum DA 


$1 


Adrl 


Dev 


Dev_Space DA 
Dev Name DS 


35 
33 



;Nombre de Param^tres 
;Numero de Device 
Dev_Space ;Pointeur sur buffer nom du Device 
;Taille du buffer 
;Nom stocke ici 

ProDos 8 : n'existe pas 

DRead 

GS/OS : $202F 

Fonction : Permet de realiser des operations de lecture de bas niveau 
sur un Device GS/OS. Sous ProDos 8, on utilise la commande 
READ BLOCK. 
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Table de Paramdtres : 
OFFSET NOM I/O DESCRIPTION 

+0 h +1 pcount I Nombre de paramfetres (6) 

+2 k +3 dev_nuni I Numero de Reference du Device 

+4 k +7 buffer O Buffer des datas 

+8^+11 request_count I Nombre d'octets ^ lire 

+12^+15 starting_block I Premier numero de bloc ^ lire 

+16^+17 bIokc_size I Nombre d'octets par bloc 

+18 k +21 transfer_count O Nombre d'octets lus 

Description des Param^tres : 

pcount : Nombre de param^tres dans la Table des Param&tres. 

dev_num : Nunnero de Reference du Device. 

buffer : Pointeur vers un buffer de sortie de classe dans lequel les 
datas vont etre lues. 

request_count : Nombre d'octets h lire. 

siarting_biock : Pour un device organise en blocs, c'est le numero de 
b'oc ou va commencer la lecture. Pour les autres devices, ce champ 
n'est pas utilise. 

block_size : Taille d'un bloc en nombre d'octets. 

transfcrcount : Nombre d'octets qui ont ete lus sur le Device. 

Codes d'erreur possibles : 

$11 : 1.^ Num6ro de Reference du Device n'est pa§ valide. 

$53 : Pfcranifetre hors des limites autorisees par GS/OS. 
autre code d'erreur possible : $07 
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Exemple de Programme : 

DRead est surtout utilisee pour lire le contenu des blocs d'un 
volume disque. Void une sous-routine GS/OS permettant de lire 
les blocs 6 et / sur un volume disque organise en blocs de 512 octets. 





JSL 


$E100A8 






DA 


$202F 


;DRead 




Adrl 


ParmTbl 






RTS 






ParmTbl 


DA 


6 


;Nombre de paramdtres 
;Numero de Device 




DA 


2 




Adrl 


Buffer 






Adrl 


1024 


;Lecture de 1024 octets 




Adrl 


100 


;En commengant k partir du 
Bloc 100 




DA 


512 


;512 octets par bloc 




DS 


4 


;Resultat tranfer_count 


Buffer 


DS 


1024 




ProDos 8 


n'existe 


pas 





DStatus 

GS/OS : $202D 

Fonction : Permet de determiner les caracteristiques d'un Device 
GS/OS. 

Table de Param&tres : 



OFFSET 



NOM 



I/O 



DESCRIPTION 



+0^+1 


pcount 


I 


+2^+3 


dev num 


I 


+4^+5 


status code 


I 


+6 a +9 


status list 


O 


+10 a +13 


request_count 


I 


+14 a +17 


transfer count 


O 



Nombre de param&tres (5) 
Numero de Reference du Device 
Code de Controle 
Pointeur sur la Liste de Controle 
Taille de la Liste de Controle 
Nombre d'octets transferes 
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Description des Param^tres : 

pcount : Nombre de param^tres dans la table des param^tres. 

dev_num : Numero de reference du device. 

status_code : Code indiquant quelle caract^ristique est demand^e. 



$0000 
$0001 
$0002 
$0003 
$0004 
$0005-$7FFF 
$8000-$FFFF 



caracteristiques du Device 
param^tres de configuration 



caracteristique attente / pas d'attente 
■ ifo 
ist 
reserve 



options de formatage 



caracteristiques de la partition 

reserve 

caracteristiques d'appels sp^cifiques 



status_list : Pointeur de classe sur un buffer contenant les 
caracteristques que la commande retourne. 

request_count : Nombre d'octets de caracteristiques k retourner 
dans la Liste de Controle. 

transfer_count : Nombre d'octets retournes dans la Liste de Con- 
trole. 

Codes d'erreur possibles : 

$11 : Numero de Reference du Device non valide. 

$53 : Param^tre hors des limites autoris^es par GS/OS. 

autre code d'erreur possible : $07 

ProDos 8 : n'existe pas 
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+0 4+1 
+2 4+3 


pcount 
dev_num 


I 
I 


+4 4+7 


buffer 


O 


+8 4+11 
+12 4+15 
+16 4+17 


request_count 
starting_block 
block_size 


I 

I 
I 


+18 4 +21 


transfer count 


o 



DWrite 

GS/OS : $2030 

Fonction : Permet de realiser des operations d'ecriture de bas 
niveau sur un Device GS/OS. 

Table de Paramtoes : 

OFFSET NOM I/O DESCRIPTION 

Nombre de param&tres (6) 
Numero de Reference du Device 
Buffer des datas 
Nombre d'octets 4 ecrire 
Premier numero de bloc 4 ecrire 
Nombre d'octets par bloc 
Nombre d'octets ecrits 

Description des Param^tres : 

pcount : Nombre de param^tres dans la Table des Param^tres. 

dev_num : Numero de Reference du Device. 

buffer : Pointeur vers un buffer contenant les datas qui vont etre 
ecrites. 

request_count : Nombre d'octets h ecrire. 

starting_block: Pour un Device organise en blocs, c'est le numero 
de bloc ou va commencer I'ecriture. Pour les autres Devices, ce 
champ n'est pas utilise. 

block_size : Taille d'un bloc en nombre d'octets. 

transfer_count : Nombre d'octets qui ont ete ecrits sur le Device. 

Codes d'erreur possibles : 

$11 : Le Numero de Reference du Device n'est pas valide. 

$53 : Param^tre hors des limites autoris6es par GS/OS. 
autre code d'erreur possible : $07 

ProDos 8 : n'existe pas 
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EndSession 

GS/OS : $201E 

Fonction : Permet de realiser toutes les operations d'ecriture de 
blocs discjue qui n'ont pas ete faites parce qu'une commande 
BeginSession est active. 

Table des Param^tres : 

OFFSET NOM I/O DESCRIPTION 

+Oa+l pcount I Nombre de param&tres (0) 

Description des param^tres : 

pcount : C'est le nombre de param^tres dans la Table des param^- 
tres. Cette valeur est toujours 0. 

Codes d'erreur possible : 

aucun 

ProDos 8 : n'existe pas 

EraseDisk 

GS/OS : $2025 

Fonction : Permet d'ecrire sur un disque le programme de boot, la 
Bit Map, et la structure du Catalogue principal vide. Cette com- 
mande efface done le volume disque. Contrairement k la com- 
mande Format, EraseDisk n'initialise pas le disaue; cela signifie 
qu'on ne peut I'utiliser qu'avec des disques ayant aejh ete formates. 

Table des Param^tres : 

OFFSET NOM I/O DESCRIPTION 

+0^+1 pcount I Nombre de parametres (4) 

+2 a +5 dev_name I Pointeur sur le nom du Device 

+6 a +9 vol_name I Pointeur sur le nom du Volume 

+10 4+11 file_sys_id O Code ID pour le fichier systeme utilise 

+12 h +13 requested_fsys I Code ID pour le fichier syst&me utilise 
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Description des Param^tres : 

pcount : Nombre de param^tres utilises dans la Table des Param^- 
tres GS/OS. La valeur minimum est 3; la valeur maximum est 4. 

dev_name : Pointeur de classe 1 sur I'adresse de la chaine d^crivant 
le nom du Device h utiliser. 

vol_name : Pointeur de classe 1 sur I'adresse de la chaine decrivant 
le nom du Volume k utiliser. Ce nom doit etre precede par un /. 

file_sys_id : Si le champ requested_fsys est k 0, GS/OS affiche une 
boite de dialogue qui permet k Tutilisateur de choisir le fichier 
syst^me utilise sur le volume disque. Au retour, le champ 
file_sys_id indique quel type de fichier syst^me a ete selectionne. 



$01 

$02 

$03 

$04 

$05 

$06 

$07 

$08 

$09 

$0A 

$0B 

$0C 



ProDos / SOS 
Dos 3.3 
Dos 3.2 / 3.1 
Apple II Pascal 
Macintosh MPS 
Macintosh HFS 
Macintosh XL (Lisa) 
Apple CP/M 
non utilise 
MS-DOS 

High Sierra (CD-ROM) 
ISO 9660 (CD-ROM) 



Si GS/OS retourne dans ce champ, cela signifie que I'utilisateur 
a annule 1' operation. 

requested_fsys : Ce champ contient le code ID du fichier syst^me k 
ecrire sur le Volume Disque. Ce code est 1^ meme que pour 
file_sys_id. Si ce champ est k 0, GS/OS affiche une boite de dialogue 
permettant de choisir le type de fichier syst^me ; GS/OS retourne 
le code ID choisi dans le champ file_sys_id. 

Codes d'erreur possibles : 

$10 : Le nom de Device indique n'existe pas. 

$40 : Le nom de Volume indique contient des caractferes non vali 
des, ou ne commence par un separateur valide (/ ou :). 

$5D : Le fichier syst^me indique n'est pas reconnu. 
autres codes d'erreur possibles : $07, $11, $27. 
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Exemple de Programme : 

Supposez que nous voulions effacer la disquette plac^e dans un 
device appele .APPLEDISK3.5A; et que nous allons lui donner 
comme nom : BLANK. 



JSL 



ParmTbl 



$E100A8 
DA $2025 
Adrl ParmTbl 
RTS 

DA 4 

Adrl DevName 
Adrl VolName 
DS 2 
DA 



;EraseDisk 



;Nombre de param^tres 

;Pointeur sur le nom de Device 

;Pointeur sur le nom de Volume 

;file_sys_id 

;0 = I'utilisateur peut choisir 



DevName ASC «.APPLEDISK3.5A» 
VolName ASC «:BLANK» 

ProDos 8 : n'existe pas 



ExpandPath 

GS/OS : $202E 

Fonction : Permet de convertir un nom de fichier, un pathname 
partiel, ou un pathname complet, en un pathname complet utilisant 
le : comme separateur. 

Table des Param^tres : 

OFFSET NOM I/O DESCRIPTION 

+0 k +1 pcount I Nombre de Param&tres (3) 

+2 k +5 input_path I Pathname devant etre converti 

+6 k +9 output_path O Pointeur sur le pathname converti 

+10^+11 flags I Indicateur de convertion en 

Majuscules 

Description des Param^tres : 

g count : Nombre de param^tres dans la Table des Param^tres GS/ 
»S. La valeur minimum est 2 ;la valeur maximum est 3. 
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input_path : Pointeur sur un buffer de classe 1 contenant la chaine 
decrivant le pathname k convertir. 

output_path : Pointeur sur un buffer de classe 1 ou GS/OS va 
retourner le pathnan\e convert!. 

flajgs : Le Bit 15 de cet indicateur montre si les caract^res en Minus- 
cules doi vent etre convertis en Majuscules. 

bit 15:1= convertir en caract^res majuscules 
= ne pas convertir 

bits 14 - : doivent toujours etre k 

Codes d'erreur possibles : 

$40 : La syntaxe du Pathname n'est pas valide. 

$4F : Le Buffer de sortie de classe 1 est trop petit pour contenir le 
resultat. 

ProDos 8 : n'existe pas 



Flush 

GS/OS : $2015 

Fonction : Force le syst^me d'exploitation k ecrire le contenu du 
buffer fichier sur le Volume Disque; le fichier n'est pas ferm^. 

Table des Param^tres : 

OFFSET NOM I/O DESCRIPTION 

+0^+1 pcount I Nombredeparam&tres(l) 

+2 k +3 ref_num I Numero de Reference du fichier 
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FLUSH 

ProDos 8 : $CD 

Fonction : meme chose pour GS/OS 

Table des Param^tres : 

OFFSET NOM I/O DESCRIPTION 

+0 num_parms I Nombredeparametres(l) 

+1 ref_num I Numero de Reference du fichier 

Description des Param^tres : 

P count / num_parms : Nombre de param^tres dans la Table des 
aran\^tres. 

ref_num : Numero de Reference attribue au fichier quand celui-ci a 
ete ouvert. 

Codes d'erreur possibles : 

$2B : Le disque est protege en ecriture. 

$43 : Le Numero de Reference du fichier n'est pas valide. Vous 
devez utiliser un Numero de Reference d'un fichier qui a 
dej^ ete ferme. 

autres codes d'erreur possibles : $04, $07, $27, $48 



Format 

GS/OS : $2024 

Fonction : Permet de formatter un disque, d'y ecrire le programme 
de boot, la Bit Map, et une structure de Catalogue vide pour le 
syst^me d'exploitation indique. 
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Table des Param^tres 



OFFSET 

+Ok+l 
+2^+5 
+6^+9 
+10 a +11 



NOM 

pcount 
dev_name 
vol_name 
file_sys_id 



I/O 

I 
I 
I 
O 



+12 a +13 requested_fsys I 
Description des Param^tres : 



DESCRIPTION 

Nombre de param&tres (4) 

Pointeur sur le nom du Device 

Pointeur sur le nom du Volume 

Code ID pour le fichier syst&me 

utilise 

Code ID pour le fichier syst&me 

utilise 



pcount : Nombre de param^tres utilises dans la Table des Param^ 
tres GS/OS. La valeur minimum est 3; la valeur maximum est 4. 

dev_name : Pointeur de classe 1 sur I'adresse de la chaine decrivant 
le nom du Device k utiliser. 

vol_name : Pointeur de classe 1 sur I'adresse de la chaine decrivant 
le nom du Volume k utiliser. Ce nom doit etre precede par un /. 

file_sys_id : Si le champ requested_fsys est h 0, GS/OS affiche une 
boite de dialogue qui permet k Tutilisateur de choisir le fichier 
syst^me utilise sur le Volume Disque. Au retour, le champ 
file_sys_id indique quel type de fichier syst^me a ete selectionne. 

$01 : ProDos / SOS 

$02: Dos 3.3 

$03: Dos 3.2/ 3.1 

$04 : Apple II Pascal 

$05 : Macintosh MPS 

$06 : Macintosh HFS 

$07 : Macintosh XL (Lisa) 

$08: Apple CP/M 

$09 : non utilise 

$0A: MS-DOS 

$0B : High Sierra (CD-ROM) 

$0C : ISO 9660 (CD-ROM) 

Si GS/OS retourne dans ce champ, cela signifie que I'utilisateur 
a annule I'operation. 

requested_fsys : Ce champ contient le code ID du fichier syst&me k 
ecrire sur le Volume Disque. Ce code est le meme que pour 
file_sys_id. Si ce champ est k 0, GS/OS affiche une boite de dialogue 
permettant de choisir le type de fichier syst^me. ; GS/OS retourne 
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le code ID choisi dans le champ file_sys_id. 

Codes d'erreur possibles : 

$10 : Le nom de Device indique n'existe pas. 

$40 : Le nom de Volume indiqu^ contient des caract^res non valides, 
ou ne commence par un separateur valide (/ ou :). 

$5D : Le fichier syst^me indique n'est pas reconnu. 

autres codes d'erreur possibles : $07, $11, $27. 

ProDos 8 : n'existe pas 

FSTSpecific 

GS/OS : $2033 

Fonction : Permet de realiser des operations propres k un FST. 

Table des Param^tres : 

OFFSET NOM I/O DESCRIPTION 

+0 k +1 pcount I Nombre de param&tres (3) 

+2 k +3 file_sys_id I Code ID du fichier syst&me 

+4 k +5 command_num I Numero de commande du 

FST 
+6 k +7/9 command_parm I/O Param&tre de la commande 

ou R^sultat 

Description des Param^tres : 

pcount : Nombre de param^tres dans la Table des Param^tres. 
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file_sys_id : Ce champ indique le fichier syst^me que le FST imple- 
mente : 



$01 

$02 

$03 

$04 

$05 

$06 

$07 

$08 

$09 

$0A 

$0B 

$0C 



ProDos / SOS 

Dos 3.3 

Dos 3.2 / 3.1 

Apple II Pascal 

Macintosh MPS 

Macintosh HFS 

Macintosh XL (Lisa) 

Apple CP/M 

non utilise 

MS-DOS 

High Sierra (CD-ROM) 

ISO 9660 (CD-ROM) 



command_num : Ce champ contient un numero de commande spe- 
cif i que au FST. 

command_parm : Ceci peut etre une entree ou un champ de resul- 
tat; cela depend de command_num. Sa signification depend du FST 
avec lequel vous communiquez. 

Code d'erreur possible : 

$53 : Paramfetre non valide 

autres codes d'erreur possibles : $04, $54 

Remarque : Cette commande permet de communiquer avec les 
FST. La nature de ces operations varie d'un FST k un autre. 

ProDos 8 : n'existe pas 



GetBootVol 

GS/OS : $2028 

Fonction : Permet de determiner le nom du Volume Disque k partir 
duquel GS/OS a ete lance. 
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Table des Paramtoes : 

OFFSET NOM I/O DESCRIPTION 

+Oa+l pcount I Nombre de param&tres (1 ) 

+2 k +5 vol_name O Pointeur sur le Nom du Volume 

Note : Le nom de Volume que GetBootVol retourne est le meme nom 
que GS/OS attribue au prefixe */ lors du boot. 

Description des Param^tres : 

pcount : Nombre de param^tres dans la Table des Param^tres. 

vol_name : Pointeur sur un buffer de classe 1 ou GS/OS retourne le 
nom du Volume Disque; ce nom est precede et suivi par le separa- 
teur : 
Le buffer doit avoir 35 octets de longueur. 

Code d'erreur possible : $07 

Exemple de Programme : 

JSL $E100A8 

DA $2028 ;GetBootVol 

Adrl ParmTbl 

RTS 

ParmTbl DA $1 ;Nombre de param^tres 

Adrl BootSpace ;Pointeur sur le buffer de sortie 

BootSpace DA 35 

BootName DS 33 ;Emplacement pour le nom 

En sortie, le nom de Volume est rang^ k BootName, il est precede 
par un mot indiquant la longueur du nom de Volume. 

ProDos 8 : n'existe pas 
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+0 


num_parms 


I 


+1 


ref_nums 


I 


+2k+3 


io buffer 


O 



GET_BUF 

GS/OS : n'existe pas 

ProDos 8 : $D3 

Fonction :Permet de determiner I'adresse de depart d'un buffer de 
1024 octets utilise par un fichier ouvert. 

Table des Paramdtres : 

OFFSET NOM I/O DESCRIPTION 

Nombre de parametres (2) 
Numero de Reference du fichier 
Pointeur sur le buffer 

Description des parametres : 

num_parms : Nombre de parametres. 

ref_num : Numero de Reference attribu^ au fichier quand celui-ci a 
ete ouvert. 

io_buffer : Pointeur sur un buffer de 1 024 octets utilise par le fichier 
ouvert. L'octet de poids f aible de ce pointeur est toujours $00, car un 
buffer commence toujours sur un saut de page memoire. 

Codes d'erreur possibles : 

$43 : Le Numero de Reference du fichier n'est pas valide. Vous 
devez utiliser le Numero de R6f6rence d'un fichier dej^ fer- 
me. 

autre code d'erreur possible : $04 

Exemple de Programme : 

Vous pouvez utiliser ce programme pour determiner I'adresse d'un 
buffer utilise par un fichier ayant le Numero de Reference 2. Apr^s 
I'execution de la commande GET_BUF, 1' adresse du buffer se trou ve 
en BUFFPTR. 
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JSR MLI 

DFB $D3 ;GET_BUF 

DA PARMTBL ;Adresse de la Table des 

;Param^tres 
BCS Error ;En cas d'erreur 

RTS 



PARMTBL DFB 2 

DFB 2 

BUFFPTR DS 2 



;Nombre de param&tres 
;Num6ro de R^f^rence du fichier 
;L'adresse du Buffer est 
;retourn6e ici 



GetDevNumber 

GS/OS : $2020 

Fonction : Permet de determiner le numero de reference d'un device 
en indiquant un nom de device ou un nom de volume. 



Table des Param^tres : 
OFFSET NOM I/O 



+oa+i 

+2^+5 



pcount 
dev name 



DESCRIPTION 

Nombre de param&tres 

Pointeur sur un nom de Device ou de 

Volume 

Numero de Reference du Device 



+6 a +7 dev_num O 

Description des Param^tres : 

pcount : Nombre de param^tres dans la Table des Param^tres. La 
valeur minimum est 1; la valeur maximum est 2. 

dev_name : Pointeur de classe 1 pointant sur I'adresse du buffer 
contenant le nom du Device ou le nom du Volume. Un nom de 
Volume doit etre precede par / ou : 

dev_num : Numero de Reference du Device retourne par la com- 
mande. 

Codes d'erreur possibles : 

$10 : Le nom de Device indique n'existe pas. 

$40 : Le nom de Volume indique contient des caract^res non valides 
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i 



ou ne commence pas avec un s^parateur valide (/ ou :). 

$45 : Le Volume indique ne peut etre trouv^. 

autres codes d'erreur possibles : $07, $11. 

Exemple de Programme : 

Voici un exemple de programme pour determiner le Numero de 
Reference d'un Device contenant un disque appel^ /PIMP : 



JSL 
DA 
Adrl 
RTS 



$E100A8 

$2020 

ParmTbl 



ParmTbl DA 2 

Adrl VolName 
DS 2 



VolName ASC «/PIMP» 
ProDos 8 : n'existe pas 



;GetDevNumber 



;Nombre de param^tres 

;Numero de Reference du 
;Device retourne ici 



GetDirEntry 

GS/OS : $201C 

Fonction : Permet de lire les caracteristiques d'un fichier du Catalo- 
gue. GS/OS retourne les informations contenues au catalogue pour 
un fichier particulier. 



Table des Param^tres : 



OFFSET 



NOM 



I/O 



tOltl 

+2 a +3 


pGOunt 

ref num 


I 

I 


+4^+5 
+6 a +7 


flags 
base 


O 

I 


+8^+9 
+10 a +13 


displacement 
name_buffer 


I 
I 


+14^+15 


entry _nuin 


o 



DESCRIPTION 

Nombrg de param^trg§ (17) 

Numero de Reference du fichier 

Indicateur pour fichier etendu 

Code de Base 

Code de Deplacement 

Pointeur sur le Nom du fichier 

Numero absolu d'Entree au Catalogue 
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+16^+17 


file_type 


O 


+18 a +21 


eof 


O 


+22 k +25 


block_count 


o 


+26 k +33 


create_td 


o 


+34 k +41 


modify_td 


o 


+42 a +43 


access 


o 


+44 k +47 


aux_type 


o 


+48 a +49 


file_sys_id 


o 


+50 k +53 


option_list 


o 


+54 ^ +57 


res_eof 


o 


+58 a +61 


res block count 


o 



Type de fichier 
Taille du fichier 

Nombre de blocs utilises par le fichier 
Heure et Date de creation 
Heure et Date de modification 
Code d'Acc&s 
Type Auxiliaire de fichier 
Code ID du syst&me d'exploitation 
Pointeur sur la Liste Option 
Taille du segment Ressource 
Nb de blocs utilises par le segment Res- 
source 



Description des Param^tres : 

pcount : Nombre de param^tres dans la Table des Param^tres. La 
valeur minimum est 5. 

ref_num : Numero de Reference attribue au fichier quand celui ci a 
ete ouvert. 

flags : Le Bit 15 de ce mot indique si le fichier est de fichier etendu 
(bit 15 = 1), ou non (bit 15 = 0). 

base : Ce code indique h GS/OS comment calculer le numero de la 
prochaine entree au catalogue k lire. Si base = 0, le deplacement est 
une entree au catalogue absolue; si base = 1, GS/OS ajoute le 
deplacement au numero courant de I'Entree pour calculer le nume- 
ro suivant d'Entree; si base = 2, GS/OS soustrait le deplacement au 
numero courant de I'Entree pour calculer le numero suivantd'en- 
tree. Notez que GS/OS fixe le numero courant d' en tree h quand il 
ouvre un fichier pour la premiere fois, et qu'il le met k jour k 
chaque fois que I'application appelle GetDir Entry. 

displacement : Si base = 0, cela represente le numero absolu de 
I'entree au catalogue k retourner. Autrement, il represente le depla- 
cement sur la prochaine entree au catalogue k retourner, qui peut 
etre positive ou negative selon la valeur de la base. 
Notez que si base et displacement sont tous les deux k 0, GS/OS 
retourne dans entry _num le nombre total d'Entrees actives dans le 
sous-catalogue. 

Pour lire dans le catalogue une Entree apr^s I'autre, fixez base 
et displacement ^ 1 et appelez GetDirEntry jusqu'^ obtenir 
I'erreur $61 (fin de catalogue). 

name_buffer : Pointeur sur un buffer de sortie de classe 1 dans 
lequel GS/OS va ranger le nom de fichier qu'il a trouve dans 
I'entree au catalogue. Sous les syst^me ProDos et GS/OS la taille du 
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buffer doit etre de 19 octets (15 pour le nom, 2 pour le mot de 
longueur, et 2 pour le mot indiquant la taille du buffer). GetDirEn- 
try pouvant etre utilisee pour lire les catalogues d'autres syst^mes 
d exploitation utilisant des noms de fichiers plus longs, il faudra 
ajuster en consequence la taille de ce buffer.Si le buffer de sortie est 
trop petit, GetDirEntry retourne la longueur necessaire au nom de 
ficnier. 

entry_num : Numero absolu de I'Entree au catalogue de I'Entr^e 
courante. 

file_type : Code indiquant le type de fichier. 

eof : Valeur contenant la position EOF courante. Cette valeur est 
egale h la taille du fichier en octets. Si le fichier est de type etendu, 
ce champ ne s'applique qu'au segment de datas. 

block_count : Ce champ contient le nombre total de blocs utilises 

gar le fichier pour le rangement de ses datas et de ses blocs d'index. 
i le fichier est de type etendu, ce champ ne s'applique qu'au 
segment de datas. 

create_td : Heure et Date de creation. Les 8 octets sont ranges dans 
I'ordre suivant : 

secondes 

minutes 

heure 

annee Annee - 1990 

jour jour du mois - 1 

mois = Janvier, 1 = Fevrier, etc ... 

non utilise 

jour de la semaine 1 = Dimanche, 2 = Lundi, etc ... 

modify _td : Heure et Date de la derni^re modification. Le format est 
le meme que pour create_td. 

access : Code d'acc^s au fichier. Voir partie consacree h I'organisa- 
tion sur disque. 

aux_type : Type Auxiliaire de fichier. 

file_sys_id : Code d'identification du fichier syst^me. 



$01 
$02 
$03 



ProDos / SOS 
Dos 3.3 
Dos 3.2 / 3.1 
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$04 
$05 
$06 
$07 
$08 
$09 
$0A 
$0B 
$0C 



Apple II Pascal 
Macintosh MFS 
Macintosh HFS 
Macintosh XL (Lisa) 
Apple CP/M 
non utilise 
MS-DOS 

High Sierra (CD-ROM) 
ISO 9660 (CD-ROM) 



Toutes les autres valeurs sont r^serv^s. 

option_list : Pointeur sur un buffer de sortie de classe 1 dans lequel 
GS/OS retourne des informations specifiques utilisees par le FST 
accedant au fichier. 

res_eof : Valeur contenant la position EOF courante du segment de 
ressource pour un fichier de type etendu. Cette valeur est egale k la 
taille du segment de ressource en octets. 

res_block_count : Ce champ contient le nombre total de blocs 
utilises par le segment ressource d'un fichier de type etendu pour 
les blocs de datas et les blocs d'index. 

Codes d'erreur possibles : 

$4F : Le buffer est trop petit pour contenir le nom du fichier. 

$61 : Fin de catalogue. Apr^s avoir obtenu cette erreur, fermez le 
fichier sous-catalogue que vous avez ouvert avant d'appeler GetDi- 
rEntry. 

autres codes d'erreur possibles : $07, $27, $43, $4 A, $4B, $52, $53, $58 

Exemple de Programme : 

Voici une sous-routine GS/OS qui permet d'afficher tous les noms 
de fichiers se trouvant dans un sous-catalogue donne; on appelle 
continuellement la commande GetDirEntry. En entree, le pomteur 
sur le pathname du sous-catalogue doit etre dans les registres A 
(mot fort) et X (mot faible). 

Catalog Debut 

STX Name_Ptr ;Pointeur sur le pointeur 

STA Name Ptr + 2 
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JSL 
DA 
Adrl 

LDA 

STA 

STA 

Lecture JSL 
DA 
Adrl 
BCS 



$E100A8 

$2010 

ParmTbll 

ref_num 

ref_numl 

ref_num2 

$E100A8 
$201C 
ParmTbl2 
EXIT 



AFFICHAGE 



BRA 


Lecture 


Exit JSL 
DA 
Adrl 
RTS 


$E100A8 

$2014 

ParmTbB 


ParmTbll DA 


2 


fef nliiTi DS 
Name_PtrDS 


2 
4 


Parmtbl2 DA 


5 


ref num2 DS 
DS 
DA 
DA 
Adrl 


2 
2 
1 
1 
NameBuff 


ParmTbl3 DA 


1 



;Commande Open 



;GetDirEntry 



i 



;Close 



;Nombre de param^tres pour 

;OPEN 

;Numefo de RlflfeRce 

;Pointeur sur le pathname 

;Nombre de param^tres pour 

;GetDirEntry 

;Numero de Reference 

;Flags 

;Base = incremente 

;Displacement = +1 

;Pointeur sur le buffer conte 

;nant le nom 

;Nombre de param^tres pour 
;Close 
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ref_numl DS 


2 


NameBuffDA 
DS 
DS 


19 

2 

15 




END 




ProDos g 


! : n'existe 


pas 


GetEOF 






GS/OS : 


$2019 





;Taille du buffer 
;Longueur 
;Nom de fichier 



Fonction : Permet de determiner dans un fichier ouvert la valeur 
courante du pointeur EOF. Cette valeur represente la taille du 
fichier. 



Table des Param^tres 
OFFSET NOM 



+Oa+l 
+2 a +3 
+4^+7 



pcount 

ref_num 

eof 



I/O DESCRIPTION 

I Nombre de parametres (2) 

I Numero de Reference du fichier 

R Position EOF 



GET_EOF 

ProDos 8 : $D3 

Fonction : menie chose que pour GS/OS. 

Table des Parametres : 

OFFSET NOM 



I/O 



DESCRIPTION 



+0 


num_parms 


I 


Nombre de param&tres (2) 


+1 


ref_num 


I 


Numero de Reference du fichier 


+2^+4 


eof 


O 


Position EOF 



Description des Parametres : 

pcount / numparms : Nombre de parametres dans la Table des 
Parametres. 
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I 

i 

i 



ref_num : Numero de Reference attribue au fichier quand celui-ci a 
ete ouvert. 

eof : Valeur representant la position courante EOF. Cette valeur est 
egale k la taille du fichier en nombre d'octets. 

Code d'erreur possible : 

$43 : Le nun^ero de Reference du fichier n'est pas valide. Vous 
devez tr^s certainement utiliser un numero d'un fichier qui a 
6te ferme. 

autre codes d'erreur possibles : $04, $07 

Exemple de Programme : 



[ 


JSL 


$E100A8 






DA 


$2019 


;GetEof 




Adrl 


ParmTbl 






BCS 


Error 


;En cas d'erreur 




RTS 






ParmTbl 


DA 


2 


;Nombre de param^tres 
;Numero de Reference du fi 




DA 


1 








;chier 


Position 


DS 


4 


;Position EOF courante 



Ce programme permet de connaitre la taille d'un fichier ayant 1 
comme Numero de Reference. 



GetFilelnfo 

GS/OS : $2006 

Fonction : Permet de retrouver I'information relative h un fichier 
stockee dans I'Entree au catalogue de ce fichier. Cela comprend le 
code d' Acc^s, le code du Type de fichier, le code du Type Auxiliaire 
de fichier, le code du Type d'Enregistrement, le nombre de blocs 
utilises par le fichier, et la Date et I'Heure de creation et de derni^re 
modification de ce fichier. 
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Table des Paramtoes : 



OFFSET NOM I/O 

+0 k +1 pcount I 

+2 k +5 pathname I 

+6 k +7 access O 

+8 k +9 file_type O 

+10 k +13 aux_type O 

+14 k +15 storage_type O 

+16 k +23 create_td O 

+24 k +31 modify_td O 

+32 k +35 optionjist O 

+36 k +39 eof O 

+40 a +43 blocks_used O 

+44 a +47 resource_eof O 

+48 k +51 resource blocks O 



DESCRIPTION 

Nombre de paramfetres (12) 

Pointeur sur le pathname 

Code d'Acc&s 

Code Type de flchier 

Code Type Auxiliaire de fichier 

Code Type d'Enregistrement 

Heure et Date de Creation 

Heure et Date de derni&re 

Modification 

Pointeur sur la Liste Option 

Taille du fichier 

Nombre de blocks utilises par 

le fichier 

Taille du segment de ressource 

Nombre de blocs du segment 

de ressource 



GET_FILE_INFO 

ProDos 8 : $C4 

Fonction : meme chose que pour GS/OS. 

Table des Param^tres : 



OFFSET 



NOM 



I/O 



DESCRIPTION 

Nombre de param^tres (10) 

Pointeur sur le Pathname 

Code d'Acces 

Code Type de fichier 

Code Type Auxiliaire de fichier 

Code Type d'Enregistrement 

Nombre de blocs utilises par le fichier 

Date de derni&re Modification 

Heure de derni&re Modification 

Date de Creation 

Heure de Creation 



Note : Quand un Pathname pointe sur le nom d'un Volume plutot 
que sur un nom de fichier, la taille du Volume (en blocs) est retour- 
nee dans le champ aux type; le nombre de blocs utilises par tous les 
fichiers de ce volume est retourne dans le champ blocks_used. 



+0 

+lk+2 

+3 


num_parms 

pathname 

access 


I 
I 
O 


+4 
+5^+6 


file_type 
aux_type 


O 

o 


+7 

+8 a +9 


storage_type 
blocks_used 


o 
o 


+10 a +11 


modify_date 


o 


+12^+13 


modify_time 


o 


+14^+15 


create_date 


o 


+16^+17 


create time 


o 
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Description des Param^tres : 

P count / num_parms : Nombre de param^tres dans la Table des 
aram^tres. Sous GS/OS, la valeur minimum est 1. 

pathname : Pointeur de classe (ProDos 8) ou de classe 1 (GS/OS) 
pointant sur I'adresse de la chaine decrivant le Pathname du fichier 
a utiliser. Si le Pathname specific n'est pas precede par un separa- 
teur (/ pour ProDos 8; / ou : pour GS/OS), le syst^me d'expioita- 
tion ajoute automatiquement le nom du prefixe par defaut (sous 
GS/OS c'est le prefixe 0/) pour creer le Pathname entier. 

access : Code d'Acc^s au fichier. Voir explications dans la partie 
consacree h I'organisation des fichiers sur un Volume. 
file_type : Code du Type de fichier. 

aux_type : Code du Type auxiliaire de fichier. 

stora^e_type : Code decrivant I'organisation physique du fichier 
sur disque : 



$01 
$02 
$03 
$04 
$05 
$0D 
$0F 



fichier "seedling" 

fichier "sapling 

fichier "tree" 

partition Pascal 

fichier de type etendu 

fichier sous-catalogue 

fichier catalogue du Volume 



blocks_used : Ce champ contient le nombre total de blocs utilises 
par le fichier pour le rangement des datas et des blocs d'index. Si le 
fichier est de type etendu, c'est seulement le nombre de blocs 
utilises par le segment de datas. Ce champ n'est pas defini sous 
GS/OS dans un fichier sous-catalogue. 

modify _date : Ce champ, sous ProDos 8 contient la date (heure, 
mois, annee) de derni^re modification du fichier. Le format est celui 
utilise par ProDos 8 pour le codage de la date. 

modify _time : Ce champ, sous ProDos 8 contient I'heure (heure, 
minute) de derni^re modification du fichier. Le format est celui 
utilise par ProDos 8 pour le codage de I'heure. 

create_date : Ce champ, sous ProDos 8 contient la date (heure, mois, 
annee) de creation du fichier. Le format est celui utilis^ par ProDos 
8 pour le codage de la date. 
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create_time : Ce champ, sous ProDos 8 contient I'heure (heure, 
minute) de creation du fichier. Le format est celui utilise par ProDos 
8 pour le codage de I'heure. 

create_td : Heure et date de creation du fichier sous GS/OS. Ces 8 
octets representent les param^tres suivants : 

secondes 

minutes 

heure 

annee Ann^e - 1990 

jour jour du mois - 1 

mois = Janvier, 1 = F^vrier, etc ... 

non utilise 

jour de la semaine 1 = Dimanche, 2 = Lundi, etc ... 

modify _td : Heure et date de derni^re modification du fichier sous 
GS/OS. Ces 8 octets sont ranges dans le meme ordre que dans le 
champ create_td. 

option_list : Pointeur sur un buffer de sortie de classe 1 ou GS/OS 
retourne des informations specifiques utilisees par le FST pour 
acceder au fichier. 

eof : Taille du fichier en nombre d'octets. Si le fichier est de type 
etendu, cette valeur ne concerne que le segment de datas. Ce champ 
n'a pas de signification pour un fichier sous-catalogue. 

resource_eof : Si le fichier est de type etendu, cette valeur est la taille 
du segment de ressource. 

resource_blocks : Si le fichier est de type etendu, cette valeur est le 
nombre de blocs utilises par le segment de ressource. 

Codes d'erreur possibles : 

$40 : Le Pathname contient des caract^res non valides, ou un Path 
name complet n'est pas specific (et il n'y a pas de prefixe par 
defaut defini). 

$44 : Un Catalogue dans un Pathname n'a pas 6te trouv^. 

$45 : Le Catalogue principal n'a pas et6 trouve. 

$46 : Le fichier n'a pas ete trouve. 
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autres codes d'erreur possibles : $04, $07, $27, $4A, $4B, $52, $53, 
$58. 

Exemple de Programme : 

Voir I'exemple donne pour la commande SetFilelnfo. 

GetFSTInfo 

GS/OS : $202B 

Fonction : Permet d'obtenir des informations g^n^rales sur les ca- 
racteristiques d'un FST. 

Table des Param^tres : 



OFFSET 


NOM 


I/O 


DESCRIPTION 


+oa+i 


pcount 


I 


Nombre de param^tres (8) 


+2^+3 


FST_num 


I 


Numero de Reference du FST 


+4 a +5 


file_sys_id 


O 


ID du fichier systfeme 


+6^+9 


FST_name 


O 


Pointeur sur le nom du FST 


+10^+11 


version 


o 


Numero de version du FST 


+12 a +13 


attributes 


o 


Attributs du FST 


+Uk+15 


block_size 


o 


Taille en Blocs 


+16^+19 


max_vol_size 


o 


Taille du Volume 


+20 k +23 


max file size 


o 


Taille du Fichier 



Description des Param^tres : 

pcount : Nombre de param^tres dans la Table des Param^tres. La 
valeur minimum est 1. 

FST_num : Numero de Reference du FST. GS/OS attribue des nu- 
meros de reference consecutifs aux differents FST qu'il trouve dans 
le syst^me. 
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file_sys_id : Code d'identification pour le fichier syst^me reconnu 
par le FST : 



$01 
$02 
$03 
$04 
$05 
$06 
$07 
$08 
$09 
$0A 
$0B 
$0C 



ProDos / SOS 
Dos 3.3 
Dos 3.2 / 3.1 
Apple II Pascal 
Macintosh MPS 
Macintosh HFS 
Macintosh XL (Lisa) 
Apple CP/M 
non utilise 
MS-DOS 

High Sierra (CD-ROM) 
ISO 9660 (CD-ROM) 



FST_name : Pointeur sur un buffer de sortie de classe 1, ou GS/OS 
retourne le nom du FST. 

version : Numero de version du FST : 

bit 15 : 1 = version prototype 

=version finale 
bits 14- 8 : Numero de version principale 
bit 7- : Nunnero de version secondaire 

attributes : Attributs du FST : 

bitl5 : 1 = les noms de fichiers doivent etre en Majuscules 

bitl4 : 1 = FST Caract^res; = FST blocks 

bitl2 : 1 = les noms de fichiers doivent §tre en ASCII positif 

block_size : Taille en octets du nombre de blocks que le FST peut 
gerer. 

max_vol_size : Taille maximum en nombre de blocs des Volumes 
Disque que le FST peut gerer. 

max_file_size : Taille maximum en nombre d'octets du nombre de 
fichiers que le FST peut gerer. 

Codes d'erreur possibles : 

$53 : ParamMres hors des limites admises par GS/OS. 

autre code d'erreur possible : $07 
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Commentaires : GS/OS ne donne pas un moyen facile pour deter- 
miner le nombre de FST actifs. Pour avoir des informations sur tous 
les FST, appelez continuellement GetFSTInfo jusqu'^ obtenir une 
erreur $53. 

ProDos 8 : n'existe pas 



GetLevel 

GS/OS : $201 B 

Fonction : Permet de determiner la valeur du niveau d'un fichier 
syst^me. 

Table des Param^tres : 

OFFSET NOM I/O DESCRIPTION 

+0 a +1 pcount I Nombre de param&tres (1) 

+2 a +3 level O Niveau du fichier systeme 

Description des Param^tres : 

pcount : Nombre de param^tres dans la Table des Param^tres. 

level : Valeur du Niveau du fichier systeme. Les valeurs retounees 
peuvent etre comprises entre $0000 et $OOFF. 

Codes d' erreur possible : $07 

Exemple de Programme : 

Voici une sous-routine sous GS/OS permettant de retourner le 
Niveau du fichier systeme : 

JSL $E100A8 

DA $201B ; GetLevel 

Adrl ParmTbl 

RTS 

ParmTbl DA 1 ; Nombre de param^tre 

level DS 2 ; Niveau du fichier Systeme retourne icl 



ProDos 8 : n'existe pas 
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GetMark 

GS/OS : $2017 

Fonction : Permet de determiner la valeur courante du pointeur 
MARK d'un fichier ouvert. 



Table des Param^tres 



OFFSET 

+0^+1 
+2^+3 
+4 a +7 



NOM 

pcount 

ref_num 

position 



I/O DESCRIPTION 

I Nombre de param&tres (2) 

I Numero de Reference du fichier 

O Position courante du Pointeur MARK 



GET_MARK 

ProDos 8 : $CF 

Fonction : meme chose que pour GS/OS 

Table des Param^tres : 

OFFSET NOM I/O 



DESCRIPTION 



+0 num_parms I Nombre de param&tres (2) 

+1 ref_num I Numero de Reference du fichier 

+2 h +4 position O Position courante du Pointeur MARK 

Description des Parann^tres : 

Pcount / num_parms : Nombre de param^tres dans la Table des 
aram^tres. 

ref_num : Numero de Reference attribue au fichier quand celui-ci a 
ete ouvert. 

position : Position courante de MARK en octets. 

Code d'erreur possible : 

$43 : Le Numero de Reference du fichier n'est pas valide. 
autre code d'erreur possible : $04, $07. 
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GetName 

GS/OS : $2027 

Fonction : Permet d'obtenir le nom de I'application en cours d'exe- 
cution. 



Table des Param^tres : 

OFFSET NOM I/O 

+0^+1 pcount I 

+2 h +5 data_buffer O 

Description des Param^tres : 



DESCRIPTION 

Nombre de paramfetres (1) 
Pointeur sur le nom de I'application 



pcount : Nombre de param^tres dans la Table des Param^tres. 

data_buffer : Pointeur sur un buffer de classe 1 dans lequel GS/OS 
3lace le nom de I'application courante. Le nom est une cnaine ASCII 
3recedee par un mot de longueur. Ce buffer doit avoir 35 octets de 
ongueur pour pouvoir y placer le nom de I'application. 

Codes d'erreur possibles : $07, $4F 

Exemple de Programme : 

Une application en execution doit parfois determiner son propre 
nom. 



JSL $E100A8 
DA $2027 
Adrl ParmTbl 
RTS 

ParmTbl DA 2 

Adrl NameSpace 

NameSpaceDA 35 
Name DS 33 

ProDos 8 : n'existe pas 



; GetName 



; Nombre de param^tres 
; Pointeur sur le buffer 

; Taille du buffer 

; Espace pour ranger le nom 
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GetPrefix 

GS/OS : $200A 

Fonction : Permet de determiner le nom d' un Prefixe GS/OS (0/ ^ 
31/). 

Table des Param^tres : 

OFFSET NOM I/O DESCRIPTION 



+0^+1 


pcount 


I 


Nombre de param&tres (2) 


+2^+3 


prefix_num 


I 


Numero du Prefixe (0 ^ 31) 


+4k+7 


prefix 


O 


Pointeur sur le Prefixe 



GET_PREFIX 

ProDos 8 : $C7 

Fonction : Permet de determiner le nom du Prefixe par defaut. 

Table des Param^tres : 

OFFSET NOM I/O DESCRIPTION 

+0 num_parms I Nombre deparamfetres (1) 

+1 k +2 prefix O Pointeur sur le Prefixe 

Description des Param^tres : 

Pcount / numparms : Nombre de param^tres dans la Table des 
aram^tres. 

prefix_num : Numero de Prefixe GS/OS (0 h 31). C'est un nombre 
binaire et pas une valeur ASCII suivie d'un /. 

prefix :Pointeur sur un buffer de sortie de classe (ProDos 8) ou de 

classe 1 (GS/OS) dans lequel le syst^me d'exploitation va 

retourner le Prefixe. 

Sous ProDos 8, ce buffer doit avoir 67 octets de longueur car un 

nom de Prefixe peut etre constitue de 64 caract^res de long; plus 

I'octet de longueur, plus les deux delimitateurs /. 

Code d'erreur possiole : 

$56 : L'adresse d'un buffer n'est pas valide car il y a un conflit en 
memoire dans les zones declarees utilisees dans la Bit Map de 
ProDos 8, ou parce que le buffer ne debute pas sur un saut de 
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page memoire. 

autres codes d'erreur possibles : $04, $07, $4F, $53. 

Exemple de Programme : 

Cette sous routine GS/OS va lire le Prefixe 7/ et le range dans un 
buffer debutant en PathName precede par un mot de longueur. 





JSL 


$E100A8 






DA 


$200A 


;GetPrefix 




Adrl 


ParmTbl 






BCS 


Error 


;En cas d'erreur 




RTS 






ParmTbl 


DA 


2 


;Nombre de param^tres 
;Numero du Prefixe (7) 




DA 


7 




Adrl 


PathBuff 




PathBuff 


DA 


69 


;Taille du buffer 


PathName 


DS 


67 





Notez que si le Prefixe 7/ n'a pas ete defini avec la commande 
SetPrefix, le mot de longueur du Prefixe retourn^ par GetPrefix est 
alors egal k 0. 



GetSysPrefs 

GS/OS : $200F 

Fonction: Permet de determiner les Preferences syst^me. 

Table des Param^tres 

OFFSET NOM I/O DESCRIPTION 



+0^+1 
+2^+3 



pcount 
preference 



Nombre de paramfetres (1 ) 
Preferences systfeme 



r^,- 



^Jr-J-;^-^ A^r- T3- 



iX4- 



■rv^ /S4-*./-»f^ 



pcount : Nombre de Param^tres dans la Table des Param.^tres. 
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preferences : Mot indiquant les Preferences syst^me : 

bit 151 = afficher la boite de dialogue Changement de Volume 
= ne pas afficher cette boite de dialogue 

Commentaires : 

Les comnnandes GS/OS qui utilisent des Pathnames comme para- 
m^tres d'entree, affichent normalement une boite de dialogue de- 
mandant k I'utilisateur d'ins^rer le Volume Disque demande si 
celui ci n'est pas en ligne. Si I'application est capaole de gerer les 
erreurs "Volume non trouve", il faut utiliser SetSysPrefs pour 
mettre ^ le bit 15 du mot de Preferences syst^me. 

ProDos 8 : n'existe pas 



GET_TIME 

GS/OS : n'existe pas 

ProDos 8 : $82 

Fonction : Permet de lire et de placer la date et I'heure dans la Page 
globale ProDos 8 aux adresses DATE ($BF90 - $BF91) et TIME 
($BF92 - $BF93). 

Tables des Param^tres : 

II n'y a pas de Table des Param^tres, la routine appelante doit 
pointer sur une adresse fictive. 

Exemple de Programme : 

Quand on utilise cette commande, la date courante (ann^e, mois, 
jour) et I'heure courante (heure, minute) sont rangees dans la Page 
globale ProDos 8 aux adresses DATE ($BF90 - $BF91) et TIME 
($BF92 - $BF93), dans le format utilise par ProDos 8. II faut bien 
entendu posseder une carte horloge compatible ProDos. 

JSR MLI 

DFB $82 ; GET_TIME 

DA $0000 ; Table des Paramdtres fictive 

RTS 
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GetVersion 

GS/OS : $202A 

Fonction : Permet de determiner le numero de version de GS/OS. 

Table des Param^tres : 

OFFSET NOM I/O DESCRIPTION 

+0^+1 pcount I Nombredeparam^tres(l) 

+2 k +3 version O Numero de version de GS/OS 

Description des Param^tres : 

pcount : Nombre de param^tres dans la Table des Param^tres. 

version : Numero de version courant de GS/OS. L'octet de poids 
fort contient le numero de version secondaire; l'octet de poids f aible 
contient le numero de version principale. Par exemple, la version 
2.1 serait codee par $0201. Le bit 7 de l'octet de poids fort s'il est k 
1 indique que la version de GS/OS est un prototype (version 
beta). 

Code d'erreur possible : $07 

ProDos 8 : n'existe pas 

NewLine 

GS/OS : $2011 

Fonction : Permet d'activer ou de desactiver le mode de lecture 
"newline". Quand le mode de lecture "newline" est active, toutes 
les operations de lecture successives se terminent k chaque fois 
qu'un caract^re determine est lu; c'est le caract^re "newline". 
Quand le mode de lecture "newline" est desactive, toutes les opera- 
tions de lecture se terminent quand la position EOF (fin de fichier) 
est atteinte, ou quand le nombre indique de caract^res a ete lu. 
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Table des Param^tres : 



OFFSET 

+0^+1 
+2^+3 
+4^+5 
+6^+7 
+8^+11 



NOM 

pcount 
ref_num 
enable_mask 
num_chars 
newline table 



I/O DESCRIPTION 



Nombre de param^tres (4) 
Numero de Reference du fichier 
Masque d'activation "newline" 
Nombre de caract&res dans la table 
Pointeur sur la table 



NEWLINE 

ProDos 8 : $C9 

Fonction : meme chose que pour GS/OS. 

Table des Param&tres : 



OFFSET NOM 



+0 
+1 
+2 
+3 



numparms 
ref_num 
enable_mask 
newline char 



I/O 

I 
I 
I 
I 



DESCRIPTION 

Nombre de param^tres (3) 
Numero de Reference du fichier 
Masque d'activation "newline" 
Caractere "newline" 



Description des Param^tres : 

Pcount / num_parms : Nombre de param^tres dans la Table des 
aram^tres. 

ref_num : Numero de Reference que le syst^me d' exploitation a 
attribue au fichier quand celui-ci a ete ouvert. 

enable_mask : Une operation mathematique AND est faite avec 
cette valeur et chaque octet lu consecutivement dans le fichier. Si le 
resultat de I'operation AND est identique h newline_char (sous 
ProDos 8), oual'un des caract^res setrouvant dans la table 
newline_table (sous GS/OS), I'operation de lecture s'arrete;autre- 
ment, la lecture continue normalement. 
Exceptior • si enable_mask est egal k 0, le mode de lecture 
"newline" est desactive, et les operations de lecture ne sont pas 
affectees. 
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num_chars : Nombre de caract^res se trouvant dans la table "ne- 
wline" des caract^res. Si enable_mask est different de 0, num_chars 
ne peut pas valoir 0. 

newline_table : Pointeur sur une table des caract^res "newline". 
Chaque caract^re occupe un octet dans la table qui peut etre cons- 
titue au maximum de 256 octets de long. 

newline_char : Valeur du caract^re new_line. Les operations de 
lecture s'arretent automatiquement si I'operation AND de 
enable_mask et du caract^re venant d'etre lu est egale k 
newline_char. 

Code d'erreur possible : 

$43 : Le Numero de Reference du fichier n'est pas valide. 

autres codes d'erreur possibles : $04, $07. 

Exemple de Programme : 

En general, on utilise la commande NewLine lorsque Ton veut lire 
une ligne h la fois dans un fichier texte. Chaque ligne dans un fichier 
texte est terminee par le code ASCII $0D qui est le code du retour 
charriot. Pour cela, il suffit de mettre enaDle_mask egal k $FF et 
newline_char k $0D avant d'executer la commande NewLine. Cer- 
taines applications travaillent en ASCII negatif et utiliseront le code 
ASCII $8D pour le retour charriot. Si vous voulez terminer une 
operation de lecture pour $0D ou $8D, utilisez un newline_char de 
$0D et un enable_mask de $7F. 





JSL 


$E100A8 






DA 


$2011 


;NewLine 




Adrl 


ParmTbl 






BCS 


Error 


;En cas d'erreur 




RTL 






ParmTbl 


DA 


4 


;Nombre de param^tres 
;Numero de Reference du 




DA 


1 








;fichier = 1 




DA 


$7F 


;enable_mask 




DA 


1 


;Nb de caract^res new_line 
;dans la table 




Adrl 


NL_Table 


;Pointeur sur la Table 
;New_Line 


NL_Table 


DA 


$0D 


;Retour charriot 
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Null 

GS/OS : $200D 

Fonction : Permet d'executer des ^venements en attente dans la liste 
d'attente GS/OS et du Scheduler. 

Table des Param^tres : 

OFFSET NOM I/O DESCRIPTION 

+0 k +1 pcount I Nombre de param&tre (0) 

ProDos 8 : n'existe pas 






ON_LINE 

GS/OS : n'existe pas 

ProDos 8 : $C5 

Fonction : Permet de determiner le nom de Volume d'un disque 
specifique, ou tous les noms de tous les Volumes ProDos 8 actifs. 
Table des Param^tres : 



OFFSET 

+0 
+1 

+2 4+3 



NOM 

num_parms 
unit_nuin 
data buffer 



I/O DESCRIPTION 

I Nombre de param&tres (2) 

I Numero d'Unite 

I Pointeur sur le buffer de datas 



Description des Param^tres : 

num_parms : Nombre de param^tres dans la Table des Param^tres. 
unit_num : Numero de slot et de drive auquel on veut acceder. 
7 6 5 4 3 2 10 



DR 


SLOT 


NON UTILISE 



SLOT peut en fait etre le numero reel ou logique d'un slot si le 
syst^me contient des peripheriques disque comme par exemple un 
RAM disque. Par exemple, le numero d unit4 d'un volume /RAM 

380 copyright Tooftoi 1990 



1 



connecte en slot 3, Drive 2 sur un lie, lie, II GS est $B0 soit 1011 0000. 

DR indique le numero de DRive (lecteur) : pour le lecteur 1 et 1 
pour le lecteur 2. Plus de deux lecteurs peuvent etre connect6s au 
port 5 du SmartPort. Dans ce cas, ProDos 8 assigne logiquement les 
deux prochains lecteurs en Slot 2, Drive 1 et en Slot 2, Drive 2. 
ProDos 8 ignore tous les lecteurs connectes au SmartPort apr^s le 
quatri^me. 

Exception : Si unit_num est egal k 0, les noms de Volume de tous 
les drives sont retournes. 

data_buf f er : Pointeur sur un buffer con tenant le nom de Volume du 
Drive specifie. Si unit_number = 0, les noms de Volume de tous les 
drives sont retournes. Chaque nom de Volume est constitue d'un 
champ de 16 octets. 

Le premier octet de chaque champ de 16 octets contient le numero 
de Drive et de slot de ce Volume disque puis la longueur du nom de 
ce Volume. Le format utilise est le suivant : 



DR 


SLOT 


LONGUEUR DU NOM 



DR et SLOT ont le meme format que unit_num. On trouve la lon- 
gueur du nom de Volume dans les 4 bits de poids faible. Les 15 
octets suivants contiennent le nom de Volume; ce nom n'est pas 
precede par un /. 

Si unit_num est egal h 0, 1'enregistrement apr^s le dernier champ 
de 16 octets commence par $00. Vous devez reserver un buffer ae 
256 octets si vous appelez ON_LINE avec unit_num = 0. 

Codes d'erreur possibles : 

$27 : Le disque est illisible. II est tr^s certainement endommag^. 
Cette erreur peut aussi survenir si la porte du lecteur est ouverte, 
ou s'il n'y a pas de disquette dans le lecteur. 

$28 : Pas de peripherigues de connectes. ProDos 8 retourne cette 
erreur quand on essaie d'acceder h un second lecteur 5.25 qui 
n'existe pas. 

$2E : Un disque a ete enleve de son lecteur, alors qu'un fichier etait 
encore ouvert. 
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$2F : Le peripherique n'est pas pret. II n'y a pas de disque dans le 
lecteur 3.5. 

$52 : Le disque dans le lecteur indique par unit_num n'est pas un 
disque formate sous ProDos. 

$56 : L'adresse du buffer pour le Pathname n'est pas valide; elle est 
declaree occupee dans la Bit Map syst^me de ProDos 8. 

autres codes d'erreur possibles : $04, $55. 

ON_LINE traite les erreurs d'une mani^re differente des autres 
commandes MLI. En cas d'erreur, "LONGUEUR DU NOM" prend 
la valeur 0, et le code d'erreur est stockee dans le deuxi^me octet de 
I'enregistrement de 16 octets correspondant. Le code d'erreur n'est 
pas range dans I'accumulateur (A), I'indicateur de carry (C) n'est 
pas mis k 1. 

Exemple de Programme : 

Ce programme lit le nom de Volume d'un disque place en Slot 6, 
Drive 2. 

JSR MLI 

DFB $C5 ;ON_LINE 

DA PARMTBL ;Adresse Table des Param^tres 

BCS ERROR ;Branchement en cas d'erreur 

RTS 



PARMTBL 


DFB 
DFB 
DA 


2 

$E0 

BUFFER 


BUFFER 


DS 


1 




DS 


15 



;Nombre de param^tres 
;unit_num = slot 6, drive 2 
;Pointeur sur le buffer du path 
;name 

;slot / drive (bits 7-4) et Longueur 
;du nom de Volume (bits 3-0) 
;Nom du Volume (ASCII) 



Si par exemple, le nom de Volume est ASM.FILES, I'octet stocks en 
BUFFER est $E9, et les octets stockes k partir de BUFFER + 1 sont 41 
53 4D 2E 46 49 4C 45 53. 

Ce sont les codes ASCII des caract&res de ASM.FILES. 
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Open 

GS/OS : $2010 

Fonction : Permet de preparer un fichier pour des operations de 
lecture et d'ecriture h venir. Quand on ouvre un fichier, le pointeur 
MARK pointe sur le debut du fichier (MARK = 0), et le niveau du 
fichier est egal au niveau du fichier syst^me. Sous GS/OS, la com- 
mande renvoie aussi tous les attributs du fichier. 

Table des Paramtoes : 



OFFSET 



NOM 



I/O 



+Oa+l 


pcount 


I 


+2^+3 


ref_num 


O 


+ik+7 


pathname 


I 


+8k+9 


request_access 


I 


+10^+11 


resource_num 


I 


+12^+13 


access 


o 


+14^+15 


file_type 


o 


+16 a +19 


aux_type 


o 


+20 a +21 


storage_type 


o 


+22 a +29 


create_td 


o 


+30 k +37 


modify_td 


o 


+38 a +41 


optionjist 


o 


+42 k +45 


eof 


o 


+46 k +49 


blocks_used 


o 


+50 a +53 


resource_eof 


o 


+54 k +57 


resource blocks 


o 



DESCRIPTION 

Nombre de parametres (15) 

Numero de Reference du fichier 

Pointeur sur le Pathname 

Type d'acc&s demande 

Type de Segment 

Code d'Acc&s 

Type de Fichier 

Type AuxiUaire de Fichier 

Type d'Enregistrement 

Heure et Date de Creation 

Heure et Date de Modification 

Pointeur sur la liste Option 

Taille du fichier 

Blocs utilises par le fichier 

Taille du segment de Ressource 

Blocs utilises par le segment Ressource 



OPEN 

ProDOS 8 : $C8 

Fonction : meme chose que pour GS/OS. 

Table des Parametres : 



OFFSET 



NOM 



I/O 



+0 

+lk+2 

+3^+4 


num_parms 

pathname 

io_buffer 


I 
I 
O 


+5 


ref num 


O 



DESCRIPTION 

Nombre de param&tres (3) 
Pointeur sur le Pathname 
Pointeur sur le buffer I/O 
Numero de Reference du fichier 
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Important : On ne peut ouvrir qu'un fichier qui est ferme, mais si un 
fichier est ouvert, et que son code d'acc^s d'autorisation d'ecriture 
n'est pas k 1 (c'est h dire que Ton ne peut pas y ecrire), ce fichier peut 
etre ouvert plus d'une fois. 

Description des Param^tres : 

P count / num_parms : Nombre de param^tres dans la Table des 
aram^tres. Sous GS/OS, la valeur minimum est 2. 
ref_num : Numero de Reference attribu^ au fichier par le syst^me 
d'exploitation. De tr^s nombreuses commandes utilisent ce Nume- 
ro de Reference pour identifier le fichier. Le niveau du fichier est 
le meme que pour le fichier systdme. 

pathname : Pointeur de classe (ProDos 8) ou de classe 1 (GS/OS) 
pointant sur I'adresse c\i la chaine decrivant le Pathname du fichier 
a utiliser. Si le Pathname specifie n'est pas precede par un 
separateur (/pour ProDos 8; / ou : pour Gb/OS), le syst^me 
d'exploitation ajoute automatiquement le nom du pr^fixe par de- 
faut (sous GS/OS c'est le prefixe 0/) pour cr^er le Pathname entier. 

request_access : Ce mot decrit le mode d'acc^s 

bit 1 1 = ecriture demandee 
bit 1 = lecture demandee 

Par ejjemple, on ne peut pas demander une Ecriture sur un lecteur 
de CD-R6m. 

Si ce mot est egal h $0000, 1'acc^s demande est le meme que celui 
permis par access_code. 

io_buffer : Pointeur sur un buffer de 1024 octets. L'octet de poids 
faible de ce pointeur doit etre h $00; cela signifie que ce buffer doit 
debuter sur un saut de page. 

La premiere moitie de ce buffer contient une copie des blocs de 
datas auxquels on vient d'acc^der; la deuxi^me moiti6 contient les 
blocs d'inaex. 

resource_num : Si le fichier est de type etendu, ce mot indique hGS/ 
OS quel segment il faut ouvrir : 

$0000 ouvrir le segment de datas 
$0001 ouvrir le segment de ressource 



Note : Le reste des param^tres dans la Liste des Paramfetres GS/OS 
3M £Qpyrightrs8fesxl§90 



est identique h celle de la commande GetFilelnfo. 

Codes d'erreur possibles : 

$40 : Le Pathname contient des caract^res non valides, ou un Path 
name complet n'est pas specifie (et il n'y a pas de prefixe par 
defaut defini). 

$42 : Tentative d'ouverture d'un 9eme fichier. Sous ProDos 8, on ne 
peut ouvrir que 8 fichiers simultanement. 

$44 : Un Catalogue dans un Pathname n'a pas et6 trouve. 

$45 : Le Catalogue principal n'a pas ete trouv6. 

$46 : Le fichier n'a pas ete trouve. 

$50 : Le fichier est ouvert. Cette commande ne fonctionne qu'avec 
des fichiers fermes. 

$56 : L'adresse d'un buffer n'est pas valide car il y a un conflit en 
memoire dans les zones declarees utilisees dans la Bit Map 
de ProDos 8, ou parce que le buffer ne debute pas sur un saut 
de page memoire. 

autres codes d'erreur possibles : $04, $07, $27, $4A, $4B, $52. 

Exemple de Programmes : 

La sous-routine suivante ouvre un fichier appele SESAME qui 
reside dans un sous catalogue ay ant pour prefixe 0/. 



JSL $E100A8 
DA $2010 
Adrl ParmTbl 
BCS Error 
RTS 

ParmTbl DA 2 
DS 2 
Adrl Pathname 



; Open 

; En cas d'erreur 



; 2 paramdtres 

; ref_num est retourn^ ici 

; Pointeur sur le Pathname 



Pathname ASC «SESAME» ; Nom du fichier 
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GS/OS retourne un code d'erreur de $46 si vous tentez d'ouvrir un 
fichier qui n'existe pas. Une fois que le fichier est ou vert, vous devez 
recuperer le Numero de Reference du fichier pour pouvoir I'utiliser 
avec les autres commandes. 



OSShutdov/n 

GS/OS : $2003 

Fonction : Permet de deconnecter GS/OS avant de rebooter ou 
d'eteindre le syst^me. 

Table des Param^tres : 

OFFSET NOM I/O DESCRIPTION 

+0 4+1 pcount I Nombredeparametres(l) 

+2 k +5 shutdown_flag I Pointeur sur le Pathname suivant 

Description des Param^tres : 

pcount : Nombre de parann^tres dans la Table des Param^tres. 

shutdown_flag : Les deux bits de poids faible de cet indicateur 
controle le mecanisme de deconnection de GS/OS : 

bit : 1 = GS/OS est deconnecte et le syst^me est reboot^ 

= GS / OS est deconnecte et I'utilisateur a le choix entre reboo- 
ter ou eteindre le syst^me. 

bit 1 : 1 = Le Ram Disque est laisse intact 

= Le Rani Disque est initialise 

Commentaires : Quand GS/OS est deconnecte, il ecrit tous les blocs 
qui se trouvent dans la memoire cache, il ferme tous les NDA ... 
Cette commande doit seulement etre utilisee par les selecteurs de 
programmes comme le Finder ou ProSel 16, et pas par les applica- 
tions. 

ProDos 8 : n'existe pas 
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I 



Quit 

GS/OS : $2029 



Fonction : Permet de quitter 1' application courante. Le controle est 
repasse au selecteur de programme. 



Table des Param^tres 



OFFSET 

+Ok+l 

+2^+5 
+6k+7 



NOM 

pcount 

pathname 

flags 



I/O DESCRIPTION 

I Nombre de param&tres (2) 

I Pointeur sur le prochain Pathname 

I Indicateurs Retour / Reboot 



QUIT 

ProDos 8 : $65 

Fonction : Meme chose que pour GS/OS. 

Table des Paramfetres : 



OFFSET 



NOM 



I/O 



+0 


num_parms I 


+1 


quit_type I 


+2 a +3 


pathname I 


+4 


reserve I 


+5 a +6 


reserve I 



DESCRIPTION 

Nombre de param&tres (4) 

Type du Quit 

Pointeur sur le prochain Pathname 

Zone reservee 

Zone reservee 



Description des Param^tres : 

Pcount / num_parms : Nombre de param^tres dans la Table des 
aram^tres. Sous GS/OS le nombre de param^tres minimum est 0. 

pathname : Pointeur sur un buffer de classe (ProDos 8) ou de 
classe 1 (GS/OS) contenant le pathname du prochain fichier sys- 
t^me h lancer. Le type de f icnier doit etre $FF (ProDos 8) ou $B3 
!GS/OS). Le pathname ne peut pas resider en page 2 car la com- 
mande Quit utilise cette zone memoire. Sous ProDos 8, ce 
champ doit etre ^ si quit_type est $00. 

auit_type : Code du type de Quit pour ProDos 8. II y a deux types 
e Quit sous ProDos 8; $00 Quit standard, $EE Quit vers un 
programme syst^me. Le code $EE peut seulement etre utilise si le 
fichier syst^me a ete lance depuis GS/OS. 
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flags :Indicateurs du type de Quit; seuls les bits 15 et 14 sont 
significatifs. Si le bit 15 est ^ 1, le UserlD du programme est place 
dans la pile de Quit, afin que le programme puisse etre relance. Si 
le bit 14 est ^ 1, le programme est relanc^ h partir de la m^moire. 

Codes d'erreur possibles : 

$46 : Le fichier n'a pas ete trouve. 

$5C : Le fichier indique par le Pathname n'est pas un programme 
executable. Ce Pathname doit etre un programme systeme ProDos 
8 (type de fichier $FF) ou un programme systeme GS/OS (type de 
fichier $B3). 

$5D : Le Pathname indique un programme systeme ProDos 8, mais 
le fichier P8 (qui contient le systeme d'exploitation ProDos 8) n'est 
pas present dans le sous-catalogue /SYSTEM du disque de boot de 
GS/OS. 

$5F : La pile des adresses de retour des Quit est saturee. GS/OS 
retourne cette erreur quand on tente de pousser un autre ID d'un 
programme sur cette pile quand celle ci est pleine. 

autres codes d'erreur possibles : $04, $07, $40, $5E. 



Read 

GS/OS : $2012 

Fonction : Permet de lire dans un fichier ouvert des octets h partir 
de la position courante du pointeur MARK. Apr^s 1' operation de 
lecture, le systeme d'exploitation incremente MARK du nombre 
d'octets qui ont ete lu dans le fichier. L' operation de lecture se 
termine quand le nombre indiqu^ d'octets a et6 transfere, quand un 
caract^re "newline" est rencontre, ou quand la fin du fichier est 
atteinte. 



i 
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lable des Param^tres : 
OFFSET NOM I/O 



DESCRIPTION 



+0^+1 


pcount 


I 


Nombre de paramfetres (5) 


+2^+3 


ref_num 


I 


Numero de Reference du fichier 


+4^+7 


data_buffer 


I 


Pointeur sur le debut du buffer de data 


+8^+11 


request_count 


I 


Nombre d'octets ^ lire 


+12^+15 


transfer_count 


O 


Nombre d'octets lus 


+16^+17 


cache_priority 


I 


Niveau de priorite du cache 



READ 

ProDos 8 : $CA 

Fonction : meme chose que pour GS/OS. 

Table des Paramtoes : 



OFFSET 



NOM 



I/O 



+0 

+1 


numparms 
ref_num 


I 
I 


+2 a +3 


data_buffer 


I 


+4^+5 
+6^+7 


request_count 
tranfer count 


I 
O 



DESCRIPTION 

Nombre de param^tres (4) 
Numero de Reference du fichier 
Pointeur sur le debut du buffer de data 
Nombre d'octets k lire 
Nombre d'octets lus 



Description des Param^tres : 

Pcount / num_parms : Nombre de param^tres dans la Table des 
aram^tres. Sous GS/OS, la valeur minimum est 2. 

ref_num : Numero de Reference attribue au fichier par le syst^me 
d' exploitation quand celui-ci a ete ouvert. 

data_buffer : Pointeur sur le debut du buffer dans lequel les datas 
du fichier vont etre placees. La taille du buffer doit etre egal h 
request_count. 

request_count : Nombre de caract^res k lire dans le fichier. lis sont 
lus dans le fichier et places dans le buffer points par data_buffer. 

transfer_count : Nombre de caract^res qui ont ete lus dans le fichier. 
II est en general egal h request_count, mais peut etre inferieur si le 
syst^me d'exploitation atteint la fin du ficnier, ou si le mode de 
lecture est actif et qu'un caract^re "newline" est lu (voir la 
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commande NewLine). 

cache_priority : Ce code indiaue comment GS/OS va utiliser le 
cache pour y placer les blocks tors de la lecture du fichier. 

$0000 : pas de cache pour ce fichier 
$0001 : le cache est utilise pour ce fichier 

Codes d'erreur possibles : 

$43 : Le numero de reference d'un fichier n'est pas valide. 

$4C : La fin du fichier (EOF) a ete atteinte durant une operation de 
lecture. 

$4E : Le syst^me d'exploitation ne peut pas acceder au fichier. Cette 
erreur arrive quand une operation interdite par le code d'acc^s 
fichier a ete demandee. Le code d'acc^s fichier controle les com- 
mandes Rename, Destroy, Read, et Write. L' erreur peut aussi sur- 
venir si on tente de detruire un sous-catalogue qui n'est pas vide. 

$56 : L'adresse d'un buffer n'est pas valide car il y a un conflit en 
memoire dans les zones declarees utilisees dans la Bit Map de 
ProDos 8, ou parce que le buffer ne debute par sur un saut de page 
memoire. 

autres codes d'erreur possibles : $04, $07, $27. 

Exemple de Programme : 



comme Nu 


mero de 


Reference 1 k 1 


'adresse memoire Buffer. 




JSL 


$E100A8 






DA 


$2012 


;Read 




Adrl 


ParmTbl 






BCS 


Error 


;En cas d'erreur 




RTS 






ParmTbl 


DA 


4 


;Nombre de param^tres 
;Numero de Reference du 




DA 


1 








;fichier 




Adrl 


Buffer 


;Pointeur sur le buffer de 
;datas 




Adrl 


$1000 


;Nombre d'octets k lire 


TransCnt 


DS 


4 


;Nombre d'octets lus 


Buffer 


DS 


$1000 


;Buffer pour les datas 
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Apr^s chaque appel h cette sous-routine, vous devez examiner le 

nombre sur 4 octets stocke en TransCnt, pour determiner le nombre 

d'octets qui ont ete lus. Ce nombre peut etre inferieur h $1000 si GS/ 

OS atteint la fin du fichier (EOF), ou s'il rencontre un caract^re 

"newline" 

Si la commande Read renvoie le code d'erreur $4C (Fin de fichier), 

il n'y a plus d'octets k lire, et on peut done fermer le fichier. 



READ_BLOCK 

GS/OS : n'existe pas 

ProDos 8 : $80 

Fonction : Permet de transferer un block de datas (512 octets) d'un 
peripherique disque vers un buffer en memoire. Sous GS/OS, on 
utilise la commande DRead. 



Table des Param^tres : 



OFFSET NOM 



+0 
+1 

+2k+3 
+4 a +5 



num_parms 
unit_nuni 
data_buffer 
block num 



I/O DESCRIPTION 

I Nombre de parametres (3) 

I Unit number 

Pointeur sur le buffer de datas 

1 Numero du bloc h lire 



Description des Parametres : 

num_parms : Nombre de parametres dans la Table des Parami^tres. 
unit_num : Numero de slot et de drive auquel on veut acceder. 
7 6 5 4 3 2 10 



DR 



SLOT 



NON UTILISE 



SLOT peut en fait etre le numero reel ou logique d'un slot si le 
syst&me contient des peripheriques disque comme par exemple un 
RAM disque. Par exemple, le numero d'unite d'un volume /RAM 
connecte en slot 3, Drive 2 sur un He, lie, II GS est $B0 soit 1 01 1 0000. 

DR indique le numero de DRive (lecteur) : pour le lecteur 1 et 1 
pour le lecteur 2. Plus de deux lecteurs peuvent etre connectes au 
port 5 du SmartPort. Dans ce cas, ProDos 8 assigne logiquement les 



copyright Toolbox 1 990 ^'jl 



deux prochains lecteurs en Slot 2, Drive 1 et en Slot 2, Drive 2. 
ProDos 8 ignore tous les lecteurs connectes au SmartPort apr^s le 
quatri^me. 

data_buf f er : Pointeur sur le debut d' un block memoire de 5 1 2 octets 
qui contient le bloc lu par READ_BLOCK. 

block_num : Numero du bloc k lire. Les valeurs autorisees depen- 
dent du peripherique disque. 

- 279 pour les lecteurs 5.25 
0-1599 pour les lecteurs 3.50 
0-127 pour les volumes /Ram 

Vous pouvez determiner la taille d'un peripherique en utilisant la 
commande GET_FILE_INFO. 

Codes d'erreur possibles : 

$27 : Le disque est illisible. II est tr^s certainement endommag^. 
Cette erreur peut aussi survenir si la porte du lecteur est ouverte, 
ou s'il n'y a pas de disquette dans le lecteur. 

$28 : Pas de peripherigues de connectes. ProDos 8 retourne cette 

orrovir quana on oeeaio d'accodor bi un Qocond loctovir 5.25 qui 

n'existe pas. 

autre codes d'erreur possibles : $04, $07, $11, $2F, $53, $56. 



RENAME 

GS/OS : n'existe pas 

ProDos 8 : C2 

Fonction : Permet de modifier le nom d'un fichier. 

Table des Param^tres : 

OFFSET NOM I/O DESCRIPTION 

+0 num_parms I Nombre de param^tres (2) 

+1 k +2 curr_name I Pointeur sur le Pathname courant 

+3 k +4 new_name I Pointeur sur le nouveau Pathname 

392 copyright Tooftox 1990 



\ 



f 



Description des Param^tres : 

num_parms : Nombre de param^tres dans la Table des Param^tres. 

curr_name : Pointeur vers un buffer de classe contenant le path- 
name du fichier k renommer. 

new_name : Pointeur vers un buffer de classe contenant le nou- 
veau pathname pour le fichier. Le fichier doit se trouver dans le 
meme sous-catalogue. 

Codes d'erreur possibles : 

$2B : Une operation d'ecriture a echoue parce que le volume disque 
est protege contre I'ecriture. 

$40 : La syntaxe du pathname n'est pas valide. 

$44 : Le Pathname specific n'a pas et6 trouv6. Cela signifie que I'un 
des noms de sous-catalogue, dans un autre pathname valide, 
n'existe pas. 

$45 : Le Volume specific n'a pas ete trouve. Cela arrive quand par 
exemple on change le disque du lecteur. 

$46 : Le fichier n'a pas ete trouve. 

$47 : Le nouveau nom de fichier existe d^j^. 

$4E : Impossible d'acceder au fichier. 

$50 : Le fichier est ouvert. On ne peut renommer que les fichiers 
fermes. 

autres codes d'erreur possibles : $04, $27, $4 A. 

Exemple de Programme : 

Voici une sous-routine permettant de changer le nom d'un fichier 
appele FILE.l dans un sous-catalogue /PROG; le nouveau nom de 
fichier sera FILE.2 dans le meme sous-catalogue. 
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JSR MLI 
DFB $C2 
DA PARMTBL 
BCS ERROR 
RTS 
PARMTBL DFB 2 ; Nombre de param^tres 

DA PATHl ; Pointeur sur le pathname actuel 
DA PATH2 ; Pointeur sur le nouveau nom 

PATHl ASC «/PROG/FILE.l» 

PATH2 ASC «/PROG/FILE.2» 



ResetCache 

GS/OS : $2026 

Fonction : Permet de forcer la taille du cache utilise par GS/OS; cette 
taille est stockee dans la Bram. 

Table des Param^tres : 

OFFSET NOM I/O DESCRIPTION 

+0 a +1 pcount I Nombre de parametres (0) 



Description des Parametres : 

Pcount : Nombre de parametres dans la Table des Parametres. 
roDos 8 : n'existe pas 
SessionStatus 

GS/OS : $201 F 

Fonction : Permet de determiner si une session d'ecriture est diffe- 
ree; c est k dire si une commande BeginSession est active. 






^94 copyright Too ftox 1 990 






Table des Param^tres : 

OFFSET NOM I/O DESCRIPTION 

+0^+1 pcount I Nombredeparametres(l) 

+2 a +3 status O Code de retour 

Description des Param^tres : 

pcount : Nombre de param^tres dans la Table des Parann^tres. La 
valeur minimum est 0. 

status : Ce code indique si une session d'ecriture est differee. 

$0000 : session d'ecriture differee active 
$0001 : session d'ecriture differee non active 

ProDos 8 : n'existe pas 



SET_BUF 

GS/OS : n'existe pas 

ProDos 8 : $D2 

Fonction : Permet de deplacer un buffer d'un fichier de saposition 
courante vers une autre zone de 1024 octets en memoire. 

Table des Param^tres : 

OFFSET NOM I/O DESCRIPTION 

+0 numparms I Nombre de param^tres (2) 

+1 ref_num I Numero de Reference du fichier 

+2 h +3 io_buffer I Pointeur sur le buffer 

Description des Param^tres : 

num_parms : Nombre de param^tres dans la Table des Param^tres. 

ref_num : Numero de Reference attribue au fichier par le syst^me 
d'exploitation. 

io_buffer : Pointeur sur un buffer de 1024 octets dans lequel le buffer 
courant va etre transfere. 
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Codes d'erreur possibles : 

$43 : Le Numero de Reference du fichier n'est pas valide. 

$56 : L'adresse du buffer pour le pathname n'est pas valide. 

autre code d'erreur possible : $04. 

Exemple de Programme : 

Le programme suivant deplace le buffer d'un fichier ayant pour 
Numero de Reference 1 de sa position courante h l'adresse $2000. 
Vous devez vous assurer que la zone $2000-$23FF n'est pas utilisee. 



JSR MLI 

DFB $D2 

DA PARMTBL 

BCS ERROR 
RTS 

PARMTBL DFB 2 ; Nombre de param^tres 

DFB 1 ; Numero de Reference du fichier 

DA $2000 ; Pointeur sur le nouveau buffer 



SetEOF 

GS/OS : $2018 

Fonction : Permet de modifier le pointeur EOF d'un fichier ouvert. 
Si on diminue EOF, tous les blocks de datas se trouvant apr^s la 
nouvelle valeur EOF sont liberes. Si on augmente EOF, le syst^me 
d'exploitation n'attribue pas de nouveaux blocks tant que d'autres 
datas ne sont pas ecrites dans ce fichier. Si la nouvelle valeur EOF 
est inferieure au pointeur MARK, ce dernier prend la valeur de 
EOF. On peut modifier la valeur EOF de tout fichier dont le bit 
d'acc^s d'ecriture est k L 
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Table des Param^tres : 

OFFSET NOM I/O DESCRIPTION 

+0 k +1 pcount I Nombre de param^tres (3) 

+2 k +3 ref_num I Numero de Reference du fichier 

+4 k +5 base I Code pour determiner la nouvelle valeur EOF 

+6 k +9 displacement I Nouvelle valeur EOF 



SET_EOF 

ProDos 8 : $D0 

Fonction : meme chose que pour GS/OS. 

Table des Param^tres : 

OFFSET NOM I/O DESCRIPTION 

Nombre de param&tres (2) 
Numero de Reference pour le fichier 
Nouvelle valeur EOF 

Description des param^tres : 

pcount / num_parms : Nombre de param^tres dans la Table des 
Param^tres. 

ref_num : Numero de Reference attribue au fichier par le syst^me 
d' exploitation. 

base : Ce code indique k GS/OS comment determiner la nouvelle 
valeur de EOF. 

$0000 : nouveau EOF = displacement 
$0001 : nouveau EOF = ancien EOF + displacement 
$0002 : nouveau EOF = MARK + displacement 
$0003 : nouveau EOF = MARK - displacement 

displacement : GS/OS utilise cette valeur en conjonction avec base 
pour determiner la nouvelle valeur du pointeur EOF. 

eof : Nouvelle valeur du pointeur EOF. 



+0 


num_parms 


I 


+1 


ref num 


I 


+2 4+4 


eof 


I 
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Codes d'erreur possibles : 

$2B : Le disque est protege contre I'ecriture. 

$43 : Le Numero de Reference du fichier n'est pas valide. 

$4D : La valeur MARK specifiee est superieure h EOF. 

$4E : Le syst^me d'exploitation ne peut pas acceder au fichier. Cette 
erreur arrive quand une operation interdite par le code d'acc^s 
fichier a ete demandee. Le code d'acc^s fichier controle les comman- 
des Rename, Destroy, Read, et Write. L' erreur peut aussi survenir 
si on tente de detruire un sous-catalogue qui n est pas vide, 
autres codes d'erreur possibles : $04, $07, $27, $4E. 



SetFilelnfo 

GS/OS : $2005 

Fonction : Permet de modifier information concernant un fichier 
dans I'Entree au catalogue. 

Table des Param^tres : 



OFFSET 



NOM 



I/O 



+Oa+l 
+2 a +5 
+6 a +7 


pcount I 
pathname I 
access I 


+8 a +9 
+10a+13 
+14^+15 


file_type I 
auxtype I 
non utilise I 


+16 a +23 


create_dt I 


+24 k +31 


modify_dt I 


+32 a +35 
+36 a +39 


optionjist I 
non utilise I 


+40 a +43 


non utilise I 


+44 a +47 


non utilise I 


+48 a +51 


non utilise I 



DESCRIPTION 

Nombre de parametres (12) 

Pointeur sur le Pathname 

Code d'Acces 

Type de fichier 

Type Auxiliaire de fichier 

Date et Heure de Creation 
Date et Heure de Modification 
Pointeur sur la liste Option 
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+0 


num_parms I 


+lk+2 


pathname I 


+3 


access I 


+4 


file_type I 


+5^+6 


a\ix_type I 


+7 


non utilise I 


+8^+9 


non utilise I 


+10 a +11 


modify_date I 


+12^+13 


modify_time I 



SET_FILE_INFO 

ProDos 8 : $C3 

Fonction : meme chose que pour GS/OS. 
Table des Paramtoes : 

OFFSET NOM I/O DESCRIPTION 

Nombre de param^tres (10) 

Pointeur sur le Pathname 

Code d'Acc&s 

Type de fichier 

Type Auxiliaire de fichier 

Date de Modification 
Heure de Modification 

Description des Param^tres : 

P count / num_parms : Nombre de param^tres dans la Table des 
aram^tres. Sous GS/OS, la valeur minimum est de 2. 

pathname : Pointeur de classe (ProDos 8) ou de classe 1 (GS/OS) 
pointant sur I'adresse de la chaine d^crivant le Pathname du fichier 
a utiliser. Si le Pathname specifie n'est pas precede par un 
separateur (/ pour ProDos 8; / ou : pour GS/OS), le syst^me 
d' exploitation ajoute automatiquement le nom du prefixe par de- 
f aut (sous GS / OS c' est le prefixe / ) pour creer le Pathname entier . 

access : Code d'Acc^s au fichier. Voir explications dans la partie 
consacree h I'organisation des fichiers sur un Volume. 

file_type : Code du Type de fichier. 

aux_type : Code du Type auxiliaire de fichier. 

non utilise : Ces octets ne sont pas utilises. lis permettent de conser- 
ver une symetrie avec la Table des Param^tres de la commande 
GET_FILE_INFO. 

modify _date : Ce champ, sous ProDos 8 contient la date (heure, 
mois, annee) de derni^re modification du fichier. Le format est celui 
utilise par ProDos 8 pour le codage de la date. 
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modify _time : Ce champ, sous ProDos 8 contient I'heure (heure, 
minute) de derni^re modification du fichier. Le format est celui 
utilise par ProDos 8 pour le codage de I'heure. ■ 

create_date : Ce champ, sous ProDos 8 contient la date (heure, mois, 
annee) de creation du fichier. Le format est celui utilise par ProDos 
8 pour le codage de la date. L 

create_time : Ce champ, sous ProDos 8 contient I'heure (heure, 
minute) de creation du fichier. Le format est celui utilise par ProDos 
8 pour le codage de I'heure. 

create_td : Heure et date de creation du fichier sous GS/OS. Ces 8 
octets representent les param^tres suivants : 

secondes 

minutes 

heure 

annee Annee - 1990 

jour jour du mois - 1 

mois = Janvier, 1 = Fevrier, etc ... 

non utilise 

jour de la semaine 1 = Dimanche, 2 = Lundi, etc ... 

modify_td : Heure et date de derni^re modification du fichier sous 
GS/OS. Ces 8 octets sont ranges dans le meme ordre que dans le 
champ create_td. | 

option_list : Pointeur sur un buffer de sortie de classe 1 ou GS/OS 
retourne des informations specifiques utilisees par le FST pour 
acceder au fichier. 

Note : Les param^tres non utilises doivent etre mis h 0. 

Codes d'erreur possibles : 

$2B : Le disque est protege contre I'ecriture. 

$40 : Le Pathname contient des caract^res non valides, ou un Path- 
name complet n'est pas specific (et il n'y a pas de prefixe par 
defaut defmi). 

$44 : Un Catalogue dans un Pathname n'a pas ete trouv6. 

$45 : Le Catalogue principal n'a pas ete trouve. 

$46 : Le fichier n'a pas ete trouve. 
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$4E : Le syst^me d' exploitation ne peut pas acc^der au fichier. Cette 
erreur arrive quand une operation interdite par le code d'acc^s 
fichier a 6t6 demandee. Le code d'acc^s fichier controle les com- 
mandes Rename, Destroy, Read, et Write. L' erreur peut aussi sur- 
venir si on tente de detruire un sous-catalogue qui n'est pas vide. 

autres codes d' erreur possibles : $04, $07, $27, $4A, $4B, $52, $53, 
$58. 



SetLevel 

GS/OS : $201 A 

Permet de fixer le niveau du fichier syst&me. 

Table des Param^tres : 

OFFSET NOM I/O DESCRIPTION 

+0^+1 pcount I Nombredeparam&tresd) 

+2 k +3 level I Nouveau niveau du fichier syst&me 

Description des Param^tres : 

pcount : Nonibre de Param^tres dans la Table des Param^tres. 

level : Valeur du niveau du fichier syst^me. La valeur peut etre 
comprise entre $0000 et $OOFF. 

Code d'erreur possible : 

$59 : Niveau de fichier non valide. 

autre code d'erreur possible : $07 

Exemple de Programme : 

Voici comment mettre le niveau du fichier syst^me k la valeur 2. 

JSL E100A8 
DA $201 A 
Adrl ParmTbl 
RTS 

ParmTbl DA 2 ; Nombre de param^tres 

DA 2 ; Nouveau niveau du fichier syst^me 
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Le niveau de fichier syst^me joue sur les commandes Open, Close, 
et Flush. 

ProDos 8 : n'existe pas 



SetMark 

GS/OS : $2016 

Fonction : Permet de modifier la valeur du pointeur MARK dans un 
fichier ouvert. On peut utiliser cette commande pour se positionner 
n'importe o I dans le fichier; les operations de lecture et d'ecriture 
prennent effet k partir de cette position. 



Table des Parann^tres : 



OFFSET 



NOM 



I/O 



+0^+1 


pcount 


I 


+2^+3 


ref_num 


I 


+4^+5 


base 


I 


+6^+9 


displacement 


I 



DESCRIPTION 

Nombre de param&tres (3) 
Numero de Reference du fichier 
Code pour determiner MARK 
Nouvelle valeur de MARK 



SET_MARK 

ProDos 8 : $CE 

Fonction : meme chose que pour GS/OS 

Table des Param^tres : 

OFFSET NOM 



I/O DESCRIPTION 



+0 num_parms I Nombre de param&tres (2) 

+1 ref_num I Numero de Reference du fichier 

+2 k +4 position I Nouvelle valeur de MARK 

Description d§§ PaFam^tF§§ : 

Pcount / num_parms : Nombre de param^tres dans la Table des 
aramtoes. 

ref_num : Numero de Reference du fichier attribu^ par la syst^me 
d' exploitation. 
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base : Ce code indique k GS/OS comment determiner la nouvelle 
valeur de MARK. 

$0000 : nouveau MARK = displacement 
$0001 : nouveau MARK = EOF - displacement 
$0002 : nouveau MARK = ancien MARK + displacement 
$0003 : nouveau MARK = ancien MARK - displacement 

position : Nouvelle valeur pour MARK. Ce pointeur ne doit pas etre 
sup^rieur k EOF. 

displacement : GS/OS utilise cette valeur en conjonction avec base 
pour determiner la nouvelle valeur du pointeur MARK. 

Codes d'erreur possibles : 

$43 : Le Numero de Reference du fichier n'est pas valide. 

$4D : Le pointeur MARK est superieur k EOF. 

autres codes d'erreur possibles : $04, $07, $27. 



SetPrefix 
GS/OS : $2009 

« 

Fonction : Permet de fixer le Pr^fixe par defaut. Quand on appelle 
une commande, le syst^me d' exploitation convertit le Pathname 
demande en y ajoutant le Pr6fixe par defaut pour obtenir le Path- 
name complet. 

Table des Param^tres : 

OFFSET NOM I/O DESCRIPTION 



+0^+1 


pcount 


I 


Nombre de param&tres (2) 


+2^+3 


prefix_num 


I 


Numero de Prefixe (0 ^ 31) 


+4^+7 


prefix 


I 


Pointeur sur le Prefixe 
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SET_PREFIX 

ProDos 8 : $C6 

Fonction : meme chose que pour GS/OS. 

Table des Param^tres : 

OFFSET NOM I/O DESCRIPTION 

+0 num_parms I Nombre de param&tres (1) 

+1 h +2 prefix I Pointeur sur le Prefixe 

Description des Param^tres : 

P count / num_parms : Nombre de param^tres dans la Table des 
aram^tres. 

prefix_num : Numero de Prefixe GS/OS (0 ^ 31). 

prefix :Pointeur de classe (ProDos 8) ou de classe 1 (GS/OS) 
pointant sur I'adresse de la chaine decrivant le Prefixe h utiliser. 

Codes d'erreur possibles : 

$40 : La syntaxe du pathname n'est pas valide. 

$44 : Le Pathname specific n'a pas et^ trouv^. 
$45 : Le Volume specifie n'a pas et6 trouv6. 

$46 : Fichier non trouve. 

$4B : Le type de fichier n'est pas valide ou n'est pas reconnu. 

autres codes d'erreur possibles : $04, $07, $27, $53. 



I 
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SetSysPrefs 

GS/OS : $200C 

Fonction : Permet de regler les Preferences syst^me. 

Table des Param^tres : 

OFFSET NOM I/O DESCRIPTION 

+0^+1 pcount I Nombredeparamfetres(l) 

+2 h +3 preference I Preferences syst&me 

Description des Param^tres : 

pcount : Nombre de Param^tres dans la Table des Param^tres. 

preferences : Mot indiquant les Preferences systfeme : 

bit 15 1 = afficher la boite de dialogue Changement de Volume 
= ne pas afficher cette boite de dialogue 

Commentaires : 

Les commandes GS/OS qui utilisent des Pathnames comme para- 
m^tres d' entree, affichent normalement une boite de dialogue 
demandant k I'utilisateur d'ins^rer le Volume Disque demand^ si 
celui ci n'est pas en ligne. Si I'application est capable de gerer les 
erreurs "Volume non trouve", il faut utiliser SetSysPrefs pour 
mettre ^ le bit 15 du mot de Preferences syst^me. 

ProDos 8 : n'existe pas 



Unbindint 

GS/OS : $2032 

Fonction : Permet d'enlever une sous-routine de gestion d'interrup- 
tion. 

Table des Param^tres : 

OFFSET NOM I/O DESCRIPTION 

+0^+1 pcount I Nombre deparamfetres(l) 

+2^+3 int_num I Numero de Reference de I'interruption 
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Description des Param^tres : 

pcount : Nombre de param^tres dans la Table des Param^tres. 

int_num : Numero de Reference que GS/OS a attribu4 h la sous- 
routine de gestion d' interruption. 

Code d'erreur possible : 

$53 : Le Numero de Reference int_num n'est pas valide. 
autres codes d'erreur possibles: $04, $0a 

ProDos 8 : n'existe pas 



Volume 

GS/OS : $2008 

Fonction : Retourne les caracteristiques du disque volume. 

Table des Param^tres : 

OFFSET NOM I/O DESCRIPTION 

Nombre de paramfetres (6) 
Pointeur sur le nom de Device 
Pointeur sur le nom de Volume 
Taille du volume en Blocs 
Nombre de Blocks inutilises 
Code ID du syst&me d'exploitation 
Nombre d'octets par Blocs 

Description des Param^tres : 

pcount : Nombre de param^tres dans la Table des Param^tres. La 
valeur minimum est 2. 

dev_name : Pointeur sur un buffer de classe 1 contenant le nom du 
Device. 

vol_name : Pointeur sur un buffer de classe 1 ou GS/OS retourne le 
nom du volume disque. Ce buffer doit avoir 35 octets. 

total_blocks : Nombre total de blocs sur le Volume Disque. 
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+0^+1 


pcount 


I 


+2^+5 


dev_name 


I 


+6^+9 


vol_name 


O 


+10^+13 


total_blocks 


O 


+14^+17 


free_blocks 


o 


+18^+19 


file_sys_id 


o 


+20 a +21 


block size 


o 



I 



free_blocks : Nombre de blocs inutilis^s sur le Volume Disque. Pour 
le format FST cette valeur est toujours ^ 0. 

file_sys_id : Code d' identification du syst^me d'exploitation utilise 
sur le volume disque. 

$00 : reserve 

$01 : ProDos / SOS 

$02 : Dos 3.3 

$03 : Dos 3.2 / 3.1 

$04 : Apple II Pascal 

$05 : Macintosh MPS 

$06 : Macintosh HFS 

$07 : Macintosh XL (Lisa) 

$08: Apple CP/M 

$09 : non utilise 

$0A: MS-DOS 

$0B : High Sierra (CD-ROM) 

$0C: ISO 9660 (CD-ROM) 

block_size : Taille d'un bloc sur disque en nombre d'octets. 

Codes d'erreur possibles : 

$10 : Le nom de Device indique n'existe pas. 

$27 : Une erreur I/O sur disque 5.25" est survenue empechant le 
transfert correct des donn^es. Le Volume disque est sans 
aucun doute abime. On obtient aussi cette erreur s'il n'y a pas 
de disque dans le lecteur. 

$28 : Pas de Device connecte. 

$2F : Le Device specifie n'est pas en Hgne. Cette erreur arrive s'il n'y 
a pas de disque dans le lecteur 3.5". 

autre codes d'erreur possibles : $07, $11, $2E, $40, $45, $4A, $52, $55, 
$57, $58. 

ProDos 8 : n'existe pas 
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Write 

GS/OS : $2013 

Fonction : Permet d'ecrire des datas dans un fichier ouvert. L'ecri- 
ture debute k la position courante de MARK. Le pointeur MARK est 
incren\ente au fur et h mesure de I'ecriture. 



i 



Table des Param^tres : 



OFFSET 



NOM 



I/O 



+0^+1 
+2^+3 


pcount 
ref_num 


I 

I 


+4^+7 


data_buffer 


I 


+8^+11 
+12^+15 


request_count 
transfer_count 


I 
O 


+16^+17 


cache_priority 


I 



DESCRIPTION 

Nombre de param&tres (5) 
Numero de Reference du fichier 
Pointeur sur le buffer de datas 
Nombre d'octets k ecrire 
Nombre d'octets ecrits 
Niveau de priorite du cache 



WRITE 

ProDos 8 : $CB 

Fonction : meme chose que pour GS/OS. 

Table des Parann^tres : 



OFFSET 



NOM 



I/O 



+0 


num_parms 


I 


+1 


ref_num 


I 


+2^+3 


data_buffer 


I 


+4^+5 


request_count 


I 


+6k+7 


transfer_count 


O 



DESCRIPTION 

Nombre de paramfetres (4) 
Numero de Reference du fichier 
Pointeur sur le debut du buffer de datas 
Nombre d'octets k ecrire 
Nombre d'octets ecrits 

Description des Param^tres : 

pcount / num_parms : Nombre de param^tres dans la Table des 
Param^tres. Sous GS/OS la valeur minimum est 4. 

ref_num : Numero de Reference du fichier attribu^ par le syst^me 
d'exploitation. 

data_buffer : Pointeur sur le debut du bloc m^moire contenant les 
datas k ecrire sur le disque. 
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request_count : Nombre de caract^res k 6crire sur disque. 

transfer_count : Nombre de caract^res Merits sur disque. 

cache_priority : Ce code indique comment GS/OS va utiliser le 
cache pour y placer les blocs lors de I'ecriture du 
fichier. 
$0000 : pas de cache p)Our ce fichier 
$0001 : le cache est utilise pour ce fichier 

Codes d'erreur possibles : 

$2B : Le disque est protege centre I'ecriture. 

$43 : Le Numero de Reference du fichier n'est pas valide. 

$48 : Le Volume est plein. 

$4E : Le syst^me d' exploitation ne peut pas acceder au fichier. 
Cette erreur arrive quand une operation interdite par le code 
d'acc^s fichier a ete demandee. Le code d'acc^s fichier controle les 
commandes Rename, Destroy, Read, et Write. L'erreur peut aussi 
survenir si on tente de detruire un sous-catalogue qui n'est pas 
vide. 

$56 : L'adresse d'un buffer n'est pas valide car il y a un conflit en 
memoire dans les zones declarees utilis6es dans la Bit Map de 
ProDos 8, ou parce que le buffer ne debute par sur un saut de 
page memoire. 

autres codes d'erreur possibles : $04, $07, $27. 

Exemple de Programme : 

Cette sous-routine GS/OS ecrit 256 octets dans un fichier dont le 
Numero de Reference est 2; les datas sont stockees en Buffer. 

JSL $E100A8 

DA $2013 

Adrl ParmTbl 

BCS Error ;En cas d'erreur 
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ParmTbl DA 


4 


DA 


2 


Adrl 


Buffer 


Adrl 


256 


TransCnt DS 


4 



Buffer 



DS 



256 



;Nombre de Param^tres 
;Num6ro de R^f^rence du fichier 
;Pointeur sur le buffer de datas 
;Nombre d'octets k ^crire 
;Nombre d'octets ecrits par GS/OS 

;Buffer 



[ 



WRITE_BLOCK 

GS/OS : n'existe pas 

ProDos 8 : $81 

Fonction : Permet de transferer le contenu du buffer memoire de 512 
octets de la memoire sur le Volume disque. 



Table des Param&tres 
OFFSET NOM 



I/O 



DESCRIPTION 



+0 


num_parms 


I 


Nombre de param&tres (3) 


+1 


unit num 


I 


Numero d'Unite 


+2 a +3 


data buffer 


I 


Pointeur sur le buffer de datas 


+4^+5 


bIock_num 


I 


Numero du block k ecrire 



Description des Param^tres : 

num_parms : Nombre de param^tres dans la Table des Param^tres. 

unit_num ; Numero d§ §lot §t d§ drivg auqu§l on v§ut aGG§d§r: 

76 543 210 



DR 


SLOT NON UTILISE 



SLOT peut en fait etre le numero reel ou logique d'un slot si le 
syst^me contient des peripheriques disque comme par exemple un 
RAM disque. Par exemple, le numero a'unit6 d'un volume /RAM 
connecte en slot 3, Drive 2 sur un He, lie, II GS est $B0 soit 1 Oil 0000. 
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DR indique le numero de DRive (lecteur) : pour le lecteur 1 et 1 
pour le lecteur 2. Plus de deux lecteurs peuvent etre connect^s au 
port 5 du SmartPort. Dans ce cas, ProDos 8 assigne logiquement les 
deux prochains lecteurs en Slot 2, Drive 1 et en Slot 2, Drive 2. 
ProDos 8 ignore tous les lecteurs connect^s au SmartPort apr^s le 
quatri^me. 

data_buffer : Pointeur sur le d^but d'un block m^moire de 512 
octets qui contient le block h ^crire par WRlTli_BLOCK. 
block_num : Numero du bloc k ecrire. Les valeurs autoris^s de- 
pendent du peripherique disque. 

- 279 pour les lecteurs 5.25 
0-1599 pour les lecteurs 3.50 
0-127 pour les volumes /Ram 

Vous pouvez determiner la taille d'un peripherique en utilisant la 
commande GET_FILE_INFO. 

Codes d'erreur possibles : 

$27 : Le disque est illisible. II est tr^s certainement endommag^. 
Cette erreur peut aussi survenir si la porte du lecteur est 
ouverte, ou s il n'y a pas de disquette dans le lecteur. 

$28 : Pas de peripheriques de connect^s. ProDos 8 retourne cette 
erreur quand on essaie d'acceder k un second lecteur 5.25 qui 
n'existe pas. 

$2B : Le disque est protege contre I'ecriture. 

autre codes d'erreur possibles : $04, $07, $11, $2F, $53, $56. 
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Son & Musique 



Qu'ils s'agissent de programmes commerciaux (notamment dans les 
jeux) ou de ceux realises par des amateurs plus ou moins eclaires, 
vous avez pu vous rendre compte des capacit^s sonores et musicales 
de votre Apple Ilgs. Je suis certain que vous n'avez pas ete degu par 
ses fantastiques possibilites dues en grande partie k son propre 
microprocesseur sonore : I'Ensoniq. Cependant il est curieux que peu 
de personnes se soient attaquees ^ la sonorisation, qui n'est pas aussi 
difficile qu'elle pourrait paraitre. Une fois la methode acquise, pro- 
grammer le son sur Apple Ilgs n'est plus que de la routine, sans pour 
autant devenir quelque chose de lassant. 

Cependant, pour pouvoir profiter au maximum du potentiel sonore 
de votre Apple Ilgs f avori, vous ne devrez pas vous contenter du haut- 
parleur interne. Le mieux est de brancher le Ilgs sur un amplificateur 
HIFI ou d'acheter specialement des enceintes amplifiees. Et, si vous 
succombez k cet acnat, pendant que vous y etes achetez aussi une 
carte stereo qui poss^de de nombreux avantages dont nous reparle- 
rons. 



6.1 Le son 



Avant de vous lancer dans de f abuleuses musiques, vous devrez tout 
d'abord apprendre k programmer I'Ensoniq pour jouer des sons, puis 
h creer vous meme vos propres sons. A ce moment 1^, vous pourrez 
dej^ appreciez toutes les possibilites de bruitages. 
Heureusement, pour vous aider, Apple a dot6 le Ilgs du fameux 
Ensoniq 5503 Digital Oscillator Chip, que nous appellerons desor- 
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mais plus communement le DOC. Outre le fait d'etre une puce utilisee 
dans plusieurs synthetiseurs, le DOC a I'avantage de pouvoir jouer 
plusieurs sons en meme temps, sans pour autant prendre de temps 
machine. C'est k dire que le microprocesseur 65C816 reste enti^re- 
ment disponible pour a'autres taches, une fois les commandes execu- 
tees. 

6.1.1. Description du syst^me 

L'Ensoniq DOC dispose d'un tr^s bon potentiel sonore puisqu'il pos- 
s^de 32 oscillateurs independants les uns des autres. Chacun des 
oscillateurs pouvant produire un son, ceci signifie que vous pouvez 
avoir jusqu'a 32 sons differents joues en meme temps ! Bien entendu 
si vous ecoutez autant de sons, vous risquez de ne plus rien entendre 
du tout pour cause de non harmonisation. Par ailleurs, chaque 
oscillateur peut fonctionner avec un volume reglable et independant 
et selon quatre modes distincts. 

II f aut remarquer que tous les registres du Sound GLU et du DOC sont 
sur 8 bits, done tous les exemples de routines sont h considerer avec 
I'accumulateur et les registres d'index XY sur 8 bits, sauf change- 
men ts precises. 

6.1.1.1. La Ram Son 

Le DOC poss&de sa propre ram de 64 K . Cependant cette ram est assez 
particuli^re, car d'une part elle n'est pas adressable par le micropro- 
cesseur 65C81 6 et d'autre part elle n'est pas executable, c'est k dire que 
meme si vous y stockez des programmes, ceux-ci ne pourront au 
aucun cas fonctionner. II est egalement important de savoir que lors 
d'un demarrage h chaud (de type Ctrl-Reset) cette Ram Son n est pas 
effacee. Par contre elle est initialisee avec des valeurs $80 lors d un 
demarrage k froid (de type Ctrl-Pomme -Reset ou lors de la mise sous 
tension de 1' Apple). Etant donne que cette ram n'est pas adressable 

gar le microprocesseur, il vous faudra passer par I'intermediaire du 
Dund GLU et de ses commutateurs. 
En ce qui concerne les valeurs k mettre en Ram Son, toute valeur de 
$01 k $FF est une constituante de son. Ainsi une onde sonore est une 
suite de valeurs qui sera ensuite convertie en un signal audible. La 
valeur $00 quant a elle est reserve pour indiquer si besoin la fin du 
son. 

Comme vous pouvez vous en douter, la Ram Son contiendra des sons, 
mais ceux-ci ne peuvent pas avoir n'importe quelle taille, ainsi les 
longueurs possibles sont : $1 00 ; $200 ; $400 ; $800 ; $1 000 ; $2000 ; $4000 
ou $8000 octets par son. Comme vous pouvez le voir, il n'y a pas de 
taille de 64 K possible normalement ; cependant nous verrons que cela 
est tout de meme realisable avec une petite astuce. De plus les sons ne 
peuvent pas commencer n'importe ou en Ram Son. Ainsi ils doivent 
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obligatoirement commencer en debut de page memoire de la Ram 

Son. 

Void un petit tableau indiquant oil peut commencer un son selon sa 

taille : 



taille 



debut du son en commencement de page de la Ram Son 



$100 

$200 

$400 

$800 

$1000 

$2000 

$4000 

$8000 



$00 ; $01 ; $02 ; $03 ; $04 
$00 ; $02 ; $04 ; $06 ; $08 
$00 ; $04 ; $08 ; $0C; $10 
$00 ; $08 ; $10 ; $18 ; $20 



$FB ;$FC ; $FD; $FE ; $FF 
$F6 ;$F8 ; $FA; $FC ; $FE 
$EC ;$F0 ;$F4;$F8 ;$FC 
$D8 ;$E0 ;$E8;$F0 ;$F8 

$00 ; $10 ; $20 ; $30 ; $40 ... $B0 ;$C0 ; $D0; $E0 ; $F0 

$00 ; $20 ; $40 ; $60 ; $80 ;$A0 ;$C0 ; $E0 

$00 ; $40 ; $80 ; $C0 

$00 ; $80 



Par exemple un son de $4000 de long (16384 octets) pourra commen- 
cer en Ram Son aux adresses $0000 ; $4000 ; $8000 ; $C000. Mais il ne 
pourra en aucun cas commencer en $0003, ni $1000, ni $C500. 
Ainsi vous remarquerez que plus un son est long, moins il y a de 
possibilites d'emplacements. Mais qu' arrive t'il si la taille d'un son ne 
correspond pas exactement aux longueurs standards ? Dans ce cas, il 
faut prendre la taille par exc^s et terminer le sons par des z^ros. 
Par exemple, si votre son occupe une taille de 13600 octets de long 
($3520), on consid^rera que sa taille est de 16384 octets ($4000) ; mais 
k partir du 13600 6me octet jusqu'au 16383 ^me, vous devrez mettre 
des zeros. E videmment les 2/84 octets k $00 sont gaspilles, sauf si vous 
arrivez h y loger un autre petit son de 2048 octets. Ainsi dans cet 
exemple, les deux sons pourraient occuper la Ram Son comme suit : 

$0000 : debut du premier son de 13600 octets declare $4000 de 

long. 
$35 IF : fin du premier son. 

$3520 : debut de la zone des $00 indiquant la fin du premier son. 
$37FF : fin de la zone des $00. 
$3800 : debut du deuxi^me son de 2048 octets declare $800 de 

long. 
$3FFF : fin du deuxi^me son. 

Quoi qu'il en soit, la zone des $00 represente encore 736 octets perdus 
ou Tonpourraiteventuellementinstaller unsonde512octets. Lamise 
en place organisee des sons peut vraiment devenir un art ! Aussi est- 
il preferable de connaitre exactement la taille de tous les sons que I'on 
desire utiliser avant de commencer la programmation. 
Malgre sa petite taille et sa relative mauvaise organisation, la Ram Son 
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reste souvent suffisante pour la plupart des bruitages ou des musi- 
ques, pour peu que Ton choisisse bien ses sons. 

6.1.1.2 Les commutateurs de controles (Sound GLU) 

Le DOC possfede ses propres registres de commandes permettant de 
le programmer compl^tement. En tout il y a 227 registres. Mais pour 
pouvoir acceder k ces registres, il vous taut passer par les quatres 
commutateurs du Sound GLU (General Logic Unit). Ce circuit est 
done un intermediaire entre le I'Ensoniq DOC et le microprocesseur 
65C816. Voici les quatre registres de commande de L'Ensoniq DOC. 
A noter que les commutateurs peuvent egalement etre acc^es en 
adressage long (exemple : $E1C03C ou $E0C03C), il n'est cependant 
pas conseille de les acceder par un adressage indexe ou autre. L'acc^s 
h la Ram Son se fait egalement via ces registres. 



Registres GLU 


Adresse 


Type 


Registre de controle du son 

Regis tre de donnee 

Registre pointeur d'adresse, octet bas 

Registre pointeur d'adresse, octet haut 


$C03C 
$C03D 
$C03E 
$C03F 


lecture/ecriture 
lecture/ecriture 
lecture/ecriture 
lecture/ecriture 



6.1.1.2/1 Le commutateur de controle du son $C03C 

Ce commutateur controle d'une part le volume general du haut- 
parleur interne, mais contient egalement c^uelques informations rela- 
tives aux acc^s du DOC. Voici la description de ses bits : 



76543210 
! ! ! ! ! 



Volume. 

Reserve, ne pas modifier. 

Auto incrementation du pointeur d'adresse. 

Acc^s au DOC ou h la Ram Son. 

DOC occupe ? 
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Bit 


Valeur 


Description 


7 


1 


Quand ce bit est ^ 1, le DOC est occupe. Attendez 
jusqu'k ce qu'il soit libre. 







Quand ce bit est k 0, le DOC est libre. 


6 


1 


Tous les acc^s se font en direction de la Ram Son. 





Tous les acc^s se font en direction des registres du 
DOC. 


5 


1 



Auto-incrementation des registres pointeurs acti 
ves. 

Auto-incrementation inactivee. 


4 


- 


Reserve, ne pas modifier. 


3-0 


$0-$F 


Controle du volume : $0 faible, $F fort. 



Le test du bit 7 de ce regis tre n'est normalement pas indispensable, car 
L'Ensoniq est assez rapide et rarement utilise en rendement maxi- 
mum. Ce bit est k lecture seulement, mais si vous ecri vez dedans, rien 
ne se produira. 

En ce qui concerne les bits 5 et 6, si vous voulez acceder aux registres 
du DOC, je vous conseille de les mettre tous deux k zero. Par contre, 
lors d'un transfert de sons de la memoire principale vers la Ram Son, 
les mettre tous deux k un. 
Le bit 4 est reserve. 

Enfin, les bits 0^3 contiennent done le volume general du haut- 
parleur interne du GS, et de la prise jack situee k I'arri&re. Cependant, 
il faut noter que ce volume n'a aucun effet dans le cas d'une carte 
stereo, car les connecteurs relies directement au DOC (sur la fiche 
interne k 7 pattes, de type connecteur Molex) ont un volume indepen- 
dant de celui du petit naut-parleur. 

Si vous tenez k mettre comme volume general celui du reglage du 
tableau de bord, sachez que la memoire $E100CA contient dans ses 
bits 0k3\e volume. 
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Exemple d'acc^s aux registres du DOC : 

LDAL $E100CA ; Lecture du volume du tableau de bord 
AND #$0F ; On ne garde que les bits ^ 3. 

STA $C03C ; Les bits 5 et 6 etant forces k zero, on 

; accede aux registres du DOC. 

Exemple d'acc^s k la Ram Son : 

LDAL $E100CA ; Volume... 

AND #%00001111 ; On ne garde que les bits ^ 3. 

ORA #%01 100000 ; On force k 1 les bits 5 et 6. 

STA $C03C ; Done on accede k la Ram Son. 



6.1.1.2/2 Le commutateur de transfert des donnees $C03D 

Qu'ils s'agissent d'acc^s au DOC ou k la Ram Son, vous devrez passer 
des donnees, et c'est justement le role du commutateur $C03D. 
Cependant ce commutateur ne fonctionne pas de la meme fagon selon 

Sue vous f aites une lecture ou une ecriture. 
)ans le cas d'une ecriture, il suffit simplement d'un STA $C03D. 

Exemple : 

LDA #$xx ; XX etant une valeur hexa quelconque 
STA $C03D ; Que Ton transf^re dans unregistredu DOC ou 
; dans une memoire de la Ram Son. 

Mais lors d'une lecture, le comportement de $C03D est different, ainsi 
si vous voulez lire une donnee, le premier octet ne doit pas etre pris 
en compte si vous venez de programmer les commutateurs de poin- 
tage ($C03E ou $C03F). Nous verrons des exemples dans le paragra- 

Ehe suivant. 
>e plus dans le cas d'une lecture d'un registre du DOC, le probl^me 
est un peu plus complexe, car vous serez amene k modifier tr^s 
souvent le commutateur $C03E, je vous conseille done tr^s vivement 
d'effectuer systfematiquement deux lectures pour lire une valeur ! 



6.1.1.2/3 Les commutateurs de pointages $C03E et $C03¥ 

Les deux commutateurs $C03E et $C03F sont utilises pour indiquer 
oil seront transferees les donnees. Dans le cas d'un acc^s au DOC, seul 
le commutateur $C03E est utilise. II suffit alors d'ecrire dans le 
commutateur quel registre du DOC vous voulez acceder. II est inutile 
de s'occuper du commutateur $C03F, lors d'un acc^s au DOC puisque 
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sa valeur n'est pas prise en compte. 

Exemple d'acc^s h un registre du DOC : 



LDAL $E100CA 
AND #$0F 
STA $C03C 
LDA #$xx 



; Tout d'abord, indiquer 

; que Ton veut acceder 

; aux registres du DOC. 

; XX 6tant un nombre hexadecimal de $00 

; k $E2 inclus, indiquant le num^ro du 

; registre du DOC. 

; Que I'on stocke dans $C03E. 



STA $C03E 

A ce stade 1^, le registre xx du DOC est pret pour etre lu ou ecrit. 

Void egalement une routine de transf ert de donnees entre la memoire 
et le DOC : 



* Ecriture des 224 premiers registres du DOC 



XC 
XC 

TAMPON = $2000 

ORG $1000 

CLC 
XCE 

SEP $30 



; Directive d'assemblage. 

; Adresse du tampon. Ou ailleurs. 
; Ou une autre adresse du banc $00. 
; Mode natif 
; A et XY sur 8 bits 



LDAL $E100CA ; Lecture du volume du tableau de bord. 
AND #$0F ; Mise k z6ro des bits 4^7 pour choisir 
STA $C03C ; le mode acc^s DOC et sans auto- 
; incrementation. 



LDX #$00 

ENCORE STX $C03E 

LDA TAMPON,X 

STA $C03D 
INX 



On veut ecrire depuis le debut du tam 

pon. 

$C03E contient le numero du registre k 

ecrire. 

Lecture d'une donnee du tampon (ici 

$2000). 

Transfert de la donnee vers le DOC. 

Valeur suivante. 
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CPX #$E0 

BCC ENCORE 

RTS ; Fin de routine 



; Jusqu'^ ce que Ton ait transfere 224 va 
; leurs. 



Cette routine permet de programn\er les registres du DOC en un seul 
transfert, mais n'est vraiment utile que pour faire des essais. Vous 
remarquerez que seuls les 224 premiers registres du DOC sont 
concemes, les trois derniers registres etant speciaux. 

De la meme faqon, void la routine inverse qui permet de lire les 
registres du DCC : 



"•= ===== = === = ======: ====== ======= =========== 

* Lecture des ??4 premiers registres du DOC 

* 


XC 
XC 




TAMPON = $2000 


; Adresse du tampon. Ou ailleur. 


ORG $1000 


; Ou ailleurs... 


CLC 

XCE 
SEP $30 


; A et XY sur 8 bits. 


LDAL$E100CA 
STA $C03C 




LDX #$00 

LDA $C03D 
LDA $C03D 
STA TAMPON,X 

INX 

CPX #$E0 
BCC ENCORE 


; A partir du premier registre. 

; Attention, il faut faire deux 

; lectures pour ne pas avoir de probl^me ! 

; Stockage de la valeur lue dans le 

; tampon. 

; Valeur suivante... 

; 224 valeurs lues ? 

; Si oui alors on a fini. 



RTS 



; Sortie du sous-programme. 
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Par centre, lors d'un acc^s a la Ram Son, I'emploi des commutateurs 
$C03E et $C03F constituent ensemble I'adresse 16 bits oil doit etre 
transferee la donnee. Ainsi $C03E contient la partie basse de I'adresse 
tandis que $C03F contient la partie haute. 

De plus, ces deux commutateurs ont la possibility d'etre auto- 
incrementes k chaque fois qu'une donnee est lue ou ecrite par $C03D. 
Ceci est particuli^rement utile lorsque vous voulez transferer des 
donnees en Ram Son. 

Void I'exemple d'une routine de transfer! de 64 K de sons du banc 
$03 vers la Ram Son. La plupart du temps, c'est une routine de ce 
genre qui est utilisee pour installer d'un coup tous les sons. Bien 
entendu, il faut prealablement charger soit meme les sons voulus 
dans le banc $03. 



* Ecriture en Ram Son de 64 K de donnees 



XC 
XC 

MEMOIRE = $030000 

ORG $1000 

CLC 
XCE 
REP $30 
SEP $20 



; Directive d' assemblage 



; Banc de stockage des sons. Ou un 

; autre. 

; Ou ailleurs.. 



; Registres XY sur 16 bits 
; et A sur 8 bits. 



LDAL $E100CA ; On choisi d'acceder k la 

AND #%00001111 ; Ram Son avec auto-incrementation 

ORA #%01100000 ; des pointeurs... 

STA $C03C 



STZ $C03E 
STZ $C03F 
LDX #$0000 
ENCORE LDAL MEMOIRE,X 

STA $C03D 



INX 



Mise k zero des 

deux pointeurs. 

On veut lire depuis le debut du banc. 

Lecture d'une valeur du banc (ici le 

banc $03). 

Transf ert en Ram Son. A noter qu' en 

meme temps les pointeurs sont 

augment^s d'une unite, done il est 

inutile de s'occuper des pointeurs. 

Valeur suivante. 



BNE ENCORE ; Jusqu'^ ce que les 64 K soit transfe 
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RTS 



;r6s. 

; Sortie du sous-programme. 



De meme void une routine de lecture de 64 K depuis la Ram Son vers 
le banc $03. II est plus rare de lire la Ram Son que d'y ecrire, mais cela 
peut parfois servir et la routine est l^g&rement differente de celle 
d'ecriture. 



* Lecture des 64 K de la Ram Son 



xc 
xc 


MEMOIRE = $030000 


ORG $1000 


CLC 
XCE 
REP $30 
SEP $20 


LDALSEIOOCA 
AND #%00001111 
ORA #%01100000 
STA $C03C 


STZ $C03E 
STZ $C03F 
LDA $C03D 


LDX #$0000 
ENCORE LDA $C03D 



; Directive d' assemblage... 

; Banc de stockage des sons. Ou un autre. 
; Ou ailleurs... 



A sur 8 bits et XY sur 16 bits. 



; Acc^s Ram Son avec auto-incrementa 
; tion. 

; Mise k zero des deux 

; pointeurs. 

; Attention ! Id on fait une permi^re lec- 

; ture pour rien, comme indiau^. Mais sur 

; tout, on I'a fait apr^s la declaration des 

; deux pointeurs et non avant ! 

; Lecture d'une valeur et incrementation 
; automatique des pointeurs. 

STALMEMOiRE,x ; Stockage... 

INX ; Valeur suivante... 

BNE ENCORE 



RTS 



; Fin de la routine. 
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6.1.1.3 Les registres du DOC 

La progr animation des 32 oscillateurs du DOC se fait par I'interme- 
diaire de ses 227 registres. Trois de ces registres concernent le DOC en 
general, mais les autres sont divises en sept series de 32 registres. 
Chaque oscillateur peut produire un et un seul son k la fois, mais 
Apple recommande de ne pas utiliser les oscillateurs 31 et 32, car ils 
sont reserves. Cependant, si vous n'utilisez pas les outils sonores 
(Sound Tools), vous pourrez les programmer sans aucun probl^me. 
Vous pouvez done avoir jusqu'^ 32 sons difMrents h la fois. 
Pour ef fecti vement produire un son, il faut choisir un oscillateur libre, 
et lui indiquer dans ses registres les elements suivants : 

- La frequence h laquelle le son sera jou6. 

- Le volume de I'osdllateur. 

- Le debut du son en Ram Son. 

- La longueur du son. 

- Le mode de fonctidffriement de I'oscillateur et son ordre de 
mise en action. 

Dans les exemples des paragraphes suivants, il faudra considerer que 
le registre de contrdle du son ($C03C) est programme pour acceder 
aux registres du DOC. Je vous rappelle les instructions qui permettent 
d'acceder au DOC : 



CLC 

XCE 

SEP $30 

LDAL$E100CA 



AND #$0F 
STA $C03C 
6.1.1.3/1 Les registres de frequence (has et haut) $00-$3F 



A et XY sur 8 bits. 

Lecture du volume general du tableau 

de bord. 

Mise h zero des bits 5 et 6 pour acceder au 

DOC 

sans auto-incrementation. 



Ce qui va determiner la hauteur du son produit est la frequence h 
laquelle le son est joue. A basse frequence, le son sera plutot grave 
alors qu'^ frequence elevee il aura tendance h etre aigu. Cependant, 
la frequence du son que Ton indique k I'oscillateur ne correspond pas 
k la frequence reelle (en hertz) ^laquelle le son est entendu. La fre- 
quence de programmation correspond k la vitesse de lecture du son 
qui se trouve en Ram Son. En effet, I'oscillateur en lui m§me ne 
produit pas de son, mais il converti chaque valeur en une tension qui 
a pour effet de faire plus ou moins viorer la membrane du haut- 
parleur. Ainsi le fait de convertir k la suite differentes valeurs va 
produire un son. Bien entendu, la r^alit^ est plus compliqu^e que cela, 
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mais nous allons nous limiter k la programmation du son, sans entrer 
dans les concepts scientifiques. 

La frequence du son doit etre donnee sur 16 bits, ce qui permet d' avoir 
65536 frequences differentes possibles. Evidemment, k partir d'une 
certaine frequence elevee, les differences ne sont plus tellement 
audible. Cependant il ne semble pas possible d'atteindre les ultra- 
sons. 

Les registres $00 k $1F contiennent la valeur basse de la frequence de 
chacun des 32 oscillateurs tandis que les registres $20 k $3F la valeur 
haute de la frequence. 

Un petit detail : si vous programmez un oscillateur avec une fre- 
quence tr^s basse ($0001 par exemple), le son sera lu tr^s lentement et 
sera k peine audible ; par contre, si vous choisissez une frequence 
nulle ($0000), le son ne sera pas lu du tout, mais I'oscillateur ne sera 
pas arrete. Ceci peut etre utilise pour interrompre momentanement 
un son, qui ensuite pourra continuer k etre joue depuis I'endroit ou il 
avait ete coupe. 

Exemple : pour mettre la frequence $156 (342) dans I'oscillateur 
n$07: 

LDA #$07 ; Le registre n $07 est celui de frequence (bas) 

STA $C03E ; de I'oscillateur n $07. 

LDA #$56 ; Partie basse de la frequence voulue. 

STA $C03D ; On stocke par I'intermediaire du registre data. 

LDA #$27 ; Le registre n $27 est quant ^ lui celui de 

STA $C03E ; frequence (haut) de roscillateur n $07. 

LDA #$01 ; Partie haute de la frequence. 

STA $C03D ; Stockage dans le DOC. 



II est egalement possible de lire si besoin les registres de frequence : 

LDA #$07 ; Frequence (bas) de I'oscillateur n $07. 

STA $C03E ; Que I'on indique dans le pointeur bas. 

LDA $C03D ; Deux lectures sont necessaires pour lire 

LDA $C03D ; une valeur valide, ne I'oubliez pas ! 

6.1.1.3/2 Les registres de volume $40-$5F 

II y a 256 volumes possibles; de plus, le fait que chaque oscillateur 
poss^de son propre volume devient tr^s interessant, surtout pour 
faire de la musique. Le volume est croissant : $00 equivaut k un son 
blanc, puisqu'il est inaudible et $FF est le volume maximum. 
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Exemple : mettre le volume de I'oscillateur n $00 au maximum : 

LDA #$40 ; Registre du volume de I'oscillateur n°$00. 

STA $C03E 

LDA #$FF ; $FF etant le volume maximum. 

STA $C03D 

6.1.1.3/3 Les registres de donnees $60-$7F 

Ces registres sont k lecture seulement. lis contiennent la derniere 
valeur de la Ram Son lue par tel ou tel oscillateur et leur emploi n'est 
pas d'une grande utilite. Cependant, nous verrons dans une autre 
partie un emploi detourne de ces registres. 

Exemple : Quelle est la derniere valeur lue par I'oscillateur n $1F ? 

LDA #$7F 

STA $C03E 

LDA $C03D 

LDA $C03D ; L'accumulateur contient cette derniere valeur. 

6.1.L3/4 Les registres pointeurs en Ram Son $80-$9F 

Pour indiquer le debut du son utilise en Ram Son par tel ou tel 
oscillateur, il suff it d'ecrire dans le registre correspondant la valeur de 
debut de page. Reportez vous au paragraphe traitant de la Ram Son 
pour savoir ou mettre les sons. 

Exemple : Nous voulons indiquer I'emplacement du son qui sera joue 
par I'oscillateur n $10. Soit un son de $4000 octets de longs (16384 
octets). II est possible de I'installer en Ram Son aux adresses suivantes 
: $0000 ; $4000 ; $8000 ; $C000. Nous choisirons pour I'exemple 
remplacemgnt en $C000 : 



LDA #$90 ;Pointeur Ram Sonde I'oscillateur n $10. 
STA $C03E 

LDA #$C0 ; Page $C0 de la Ram Son (pour I'adresse $C000). 
STA $C03D 
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6.1.1.3/5 Les registres de controle des oscillateurs $AO-$BF 



Ce sont les registres qui contiennent le plus d'informations. Void la 
description des bits a'un de ces registres : 



76543210 
! ! ! 
I I 



Arret/marche de I'osdllateur. 
_ Mode de fonctionnement de I'osdllateur. 
_ Indicateur de mise en activite d'interruption. 
Canal de sortie du son. 



Bit 


Valeur 


Description 


7-4 


$0-$F 


Determine un des 16 canaux de sortie du son. 


3 


1 


L'oscillateur produira une interruption k la fin du 
son. 







Aucune interruption ne sera produite. 


2-1 




1 

1 
1 1 


Mode «Free-run». Le son est automatiquement 

repete. 

Mode «One-shot». Arr^t de I'osdllateur en fin de son. 

Mode «Sync». Synchronisation de deux oscillateurs. 

Mode «Swap». Alternation de deux oscillateurs. 





1 


L'osdllateur est en arr§t. 





11 est en activite. 



Les bits 7^4 contiennent done le numero du canal de sortie du son 
joue par I'osdllateur en question, ce qui permet avec une carte stereo 
d'entendre les sons sur les enceintes gauche ou droite. Pour I'instant 
seules les cartes stereo existent, mais il serait tout k fait possible de 
f abriquer des cartes avec 4,6 ou 8 haut-parleurs branches, permettant 
ainsi d'extraordinaires effets... Cependant, bien que Ton puisse pro- 
grammer jusqu'^ 16 canaux de sortie, seulement 8 sont r^Uement 
accessibles etant donne qu'il n'y a que trois des quatres broches 
«Channel address» qui sont effectivement relics au connecteur J25. 

Mais de toute f aqon, comme la carte st6r^ est le standard, il suff ira de 
commuter le bit 4, les trois autres restant h z§ro. On obtient done une 
sortie h. droite si le bit 4 est ^ et ^ gauche s'il est ^ 1. 
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Si I'oscillateur arrive k la fin d'un son et que le bit 3 de son registre de 
contrdle est h 1, il enverra un signal d' interruption au microproces- 
seur . Bien entendu ce signal est trai table et Ton peut mdn\e savoir quel 
oscillateur I'a envoy^. 

Les modes de fonctionnement des oscillateurs determinent la f agon 
dont le son va etre joue. Les bits 2 et 1 commutent les dif ferents modes. 
Ainsi le mode «Free-run» permet de produire un son aui une fois fini 
se repetera indefiniment depuis le debut. A I'oppose le mode «One- 
shot» arretera I'osdllateur a^s la fin du son. Les deux autres modes 
ont une utilisation plus particuli^re dont nous reparlerons dans le pa- 
ragraphe specialement consacre aux quatre modes. 

Enfin, le bit est I'indicateur de marche de I'oscillateur. S'il est k cela 
signifie que I'oscillateur est en train de produire un son, tandis qu'& 
1 il est arrete et ne produit done aucun son. Ainsi, il suffit de program- 
mer ce bit pour mettre I'oscillateur en action, mais il faut egalement 
savoir que la commutation de ce bit peut se faire automatiquement 
selon les modes de fonctionnement. Ainsi avec le mode «One-shot» 
lorsque le son a ete joue en entier, le DOC arrete automatiquement 
I'osallateur et le bit de son registre de controle est done mis k 1. 

Exemple : nous voulons que I'osdllateur n $05 joue un son unique, 
sur le naut-parleur de gauche, sans produire d'mterruption : 



1 ) Pour jouer sur le haut-parleur de gauche, il faut mettre $1 dans 
les bits 7 ^ 4 du registre $A5 (0001 en binaire). 

2) Le bit 3 doit etre k puisqu'aucune interruption ne doit etre 
produite. 

3) Pour un son unique, il faut le mode «One-shot», done les bits 
2 et 1 doivent contenir et 1. 

4) Pour la mise en marche de I'oscillateur, il faut mettre dans 
le bit 0. 

Ainsi il faut mettre la valeur binaire 00010010 ($12) dans le registre 
$A5. 



LDA #$A5 ; Regisfa-e de contr61e de I'oscillateur n $05. 
STA $C03E 

LDA #$12 ; Son unique k gauche, sans interruption. 
STA $C03D 
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6.1.1.3/6 Les registres de taille des sons $CO-$DF 



II nous reste encore h indiquer la taille du son utilisee par I'oscillateur 
desire. C'est entre autre le role des registres de la serie $C0 dont voici 
la description : 



76543210 
!!!!!! 
Ill 



Codage de la resolution. 
_ Codage de la taille du son. 

Reserve, doit etre k 0. 

Reserve. 



Bit 


Valeur 


Description 


7 


- 


Reserve. 


6 





Reserve k 1' extension de la Ram Son. 11 faut mettre 






Codage de la taille des sons : 




000 


256 octets ($0100) 




001 


512 octets ($0200) 




010 


1024 octets ($0400) 


5-3 


oil 


2048 octets ($0800) 




100 


4096 octets ($1000) 




101 


8192 octets ($2000) 




110 


16384 octets ($4000) 




111 


32768 octets ($8000) 


2-0 


$0-$7 


Resolution d'adressage. 



Le bit 7 est reserve et le mettre k zero conviendra sans probl^me. 
Par contre, le bit 6 doit absolument etre mis k z^ro, car il est reserve 
pour une eventuelle extension de la Ram Son. H se pourrait qu'un 
futur GS utilise 128 K de Ram Son et dans ce cas le bit 6 aurait le role 
de commuter entre les deux bancs. Done, afin de ne pas avoir de 
mauvaise surprise de compatibilite avec les «prochains GS», restez 
d'office dans le premier banc en mettant ce bit k zero. 
La taille du son est done codec avec les bits 5^3, pas de probl^me 
particulier si ce n'est de bien choisir la taille des sons et leurs empla- 
cements. 

La resolution d'adressage qui est cod^ avec les bits 2 ^ est d'un 
usage peu evident. EUe determine selon son codage et selon la taille 
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du son le nombre d' octet effectivement pris en compte lors de la 
lecture de la Ram Son par un oscillateur. Ainsi h frequence et resolu- 
tion egales un son de differente taille n'aura pas la meme hauteur. 
Heureusement, le fait de choisir la resolution proportionnellement h 
la taille du son annule cet effet le plus souvent ind^sirable. Afin de 
vous aider dans le calcul des valeurs k mettre dans le registre de taille 
des sons, void un petit tableau indiquant les bonnes valeurs selon les 
differentes tallies de sons : 



taille du son 


valeur k mettre dans le registre de la serie $C0 


256 $0100 


$00 (%00000000) 


512 $0200 


$09 (%00001001) 


1024 $0400 


$12 (%00010010) 


2048 $0800 


$1B (%00011011) 


4096 $1000 


$24 (%00100100) 


8192 $2000 


$2D (%00101101) 


16384 $4000 


$36 (%00110110) 


32768 $8000 


$3F (%00111111) 



Exemple : Soit un son de $4000 octets de long (16384 octets). Nous 
voulons I'indiquer pour I'oscillateur n $15. 

LDA #$D5 ; Registre de taille du sonde I'oscillateur n $15. 
STA $C03E 

LDA #$36 ; Selon la tableau, c'est la valeur $36 qui 

STA $C03D ; convient. 

6.1.1.3./7 Le registre des interruptions $E0 

Ce registre, comme les deux suivants ne concerne pas un oscillateur 
en parti culier, mais le DOC en general. Le registre n $E0 s'occupe des 
interruptions sonores en indiquant tout d'abord si une interruption a 
ete provoquee, et si tel est le cas lequel des 32 oscillateurs en est 
I'origine. A noter que ce registre est k lecture seulement. 

Void la description des differents bits : 

76543210 

! ! ! ! ! ! Reserve. 

I I I I I 



Numero de I'oscillateur ayant provoque I'interruption. 

_ Reserve. 

_ Indicateur d'interruption. 
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Bit 


Valeur 


Description 


7 


1 



Aucun oscillateur n'a produit d'interruption. 

Un des 32 oscillateurs est k I'origine de I'interruption. 


6 


- 


Reserve. 


5-1 


$0-$lF 


Contient le numero de I'oscillateur ayant produit 
I'interruption. 





- 


Reserve. 



L'indicateur d'interruption (bit 7) n'a d'int^ret que si vous gerez vous 
m§me les interruptions. Dans ce cas, il permet de savoir que c'est le 
DOC qui a provoque I'interruption et non autre chose (VGC, Horloge, 
souris, etc.). Bien entendu, si vous decidez de gerer vous meme les 
interruptions, vous devrez f aire une routine de sondage qui aura pour 
but de reperer la source de I'interruption. Mais le GS poss^de dej^ un 
excellent syst^me de gestion des interruptions employant differents 
vecteurs de branchement. Dans le cas du son, il se trouve en $E1002C. 
Par contre, il peut etre tr^s utile de savoir lequel des 32 oscillateurs 
a ^enere I'interruption, sauf s'il est prevu qu'un seul oscillateur 
puisse le f aire. Done, en cas d'interruption, les bits 5 ^ 1 du registre $E0 
contiennent le numero de I'oscillateur, qu'il faudra ensuite traiter. 

Exemple : Extrait d'une routine de gestion d'interruption : 

On supposera que le microprocesseur 65C816 vient de produire une 
interruption et qu'il se soit branche sur votre routine de gestion 
d'interruption. Cette routine h pour but de connaitre I'origine de 
I'interruption... 

; D'autres instructions auraient id pour but de 
; savoir si c'est le VGC, la souris, ou autre qui 
; vient de provoquer interruption... 



LDA #$E0 
STA $C03E 
LDA $C03D 
LDA $C03D 
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; Etant donne qu'ici ni le VGC, ni la souris n'ont 
; produit d'interruption, peut etre que c'est le 
; DOC ? On va done lire le registre $E0. 
; Mais n'oubliez pas qu'il faut deux lectures ! 



I 



BPL INTERSON ; Si I'accumulateur est positif (bit 7^0) alors 
; oui, c'est bien une interruption sonore. On va 
; se branch er h la gestion. 

; Non, ce n'est pas le DOC... C'est done autre 
; chose, il faut continuer k sonder... 



* Gestion de I'interruption sonore 



INTERSON AND #%00111110 
LSR 



On ne garde que les bits 5^1. 

Un petit decalage h droite et I'accu 

muiateur 

contient maintenant le numero de 

I'oscillateur 

qui a provoque interruption. 

Suite de la routine... 



6.1.1.3/8 Le registre de fonctionnement des oscillateurs $E1 



Normalement les 32 oscillateurs sont en fonction et chacun d'eux 
prend 1,2 micro seconde en temps machine, ce qui fait environ 38 
micro secondes pour les 32. Ce temps est negligeable, mais si pour une 
raison ou une autre vous voudriez aller plus vite, il est possiole de ne 
selectionner qu'une partie des oscillateurs. Toutefois il faut au mini- 
mum qu'un oscillateur soit en fonction, et il n'est possible de les 
mettre en action que dans un ordre sequentiel. Pour choisir le nombre 
d'oscillateurs que vous voulez, il sufrit de multiplier ce nombre par 
deux et de I'indiquer via le registre $E1. 

Mais le fait d'avoir moins d'oscillateurs en meme temps provoque 
done une acceleration du traitement, et les frequences reelles des sons 
s'en trouvent egalement modifies. Done je recommande absolument 
de garder 32 oscillateurs aetifs etant donne que le gain de temps n'en 
vautpas la peine. 

Les 32 oscillateurs sont d'office selectionnes lors du demarrage de la 
machine ou apr^s un Reset, mais il est plus prudent de I'indiquer 
avant de commeneer une utilisation du son (u faut toujours penser 
qu'un jour cela pourrait ne plus etre compatible). Void done les 
quelques instructions necessaires : 



m 
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LDA #$E1 ; Registre $E1. 

STA $C03E 

LDA #$40 ; On veut 32 oscillateurs. Mais il faut multiplier 

STA $C03D ; ce nombre par 2, d'ou en hexa $40. 



6.1.1.3/9 Le registre de numerisation $E2 

L'Ensoniq est dote d'un syst^me de nunnerisation qui permet d'ac- 
auerir des donnees de type analogique et de les con vertir en nombres 
de ^ 255. Bien entendu ce syst^me est utilise en priorite pour la 
numerisation du son depuis un magnetophone par exemple, mais 
rien n'empeche de I'utiliser pour d'autres genres de numerisations. 
Pour numeriser des donnees, il suffit de relier deux f ils au connecteur 
du DOC, I'un h la masse (broche n 2) et I'autre h I'entree du conver- 
tisseur (broche n 1), le tout bran che h la source. Cependant la tension 
maximale admise lors de I'acquisition des donnees est de 2,5 volts 
avec une impedance maximale de 3000 ohms. II vous est vivement 
conseille DE NE PAS DEPASSER CES V ALEURS pour ne pas mettre 
I'Ensoniq, voire le GS en danger. De toute fagon si vous decidez 
d'utiliser la numerisation en bricolant vous meme, ce sera k vos 
risques et perils. De plus, si vous souhaitez numeriser du son et 
travailler avec soin et facilite, mieux vaut vous acheter une carte d'ex- 
tension stereo-numerisante. 

En ce qui conceme la routine de numerisation, sachez que le DOC 
prend 31 micro secondes pour convertir une valeur et qu'il vous 
raudra done attendre suffisament de temps entre chaque cycle d'ac- 
quisition, sous peine de manquer des valeurs. Si vous souhaitez 
travailler sur des temps precis, je vous conseille de commuter la 
cadence du GS en 1 Mhz, ce qui facilitera le calcul des temps. 
Dernier point : ce registre est k lecture seulement, mais vous vous en 
seriez doute ! 

Void une routine exemple qui a pour but de numeriser 64 K de donne. 



* Exemple d'une routine de numerisation 

XC ; Directive d'assemblage 

XC ; 

MEMOIRE = $030000 ; Banc de stockage des donnees. Ou un autre. 

ORG $1000 ; Ou ailleurs... 

CLC ; Mode natif. 
XCE 
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REP $30 ; 

SEP $20 ; 

LDA #$80 ; 

TRB $C036 ; 

LDAL $E100CA 
AND #$0F 

STA $C03C i 

LDA #$E2 ; 
STA $C03E 

LDA $C03D ; 



XY sur 16 bits 
et A sur 8 bits. 

Mise en vitesse 1 Mhz du GS en mettant 

lebit7 

du commutateur $C036 h zero. 

; Volume selon celui du beep. 

; Acc^s aux registres du DOC. 

; Choix du registre de numerisation 

; Premiere lecture pour rien. Remarauez 
; qu'ici nous n'appliquons pas la r^gle de 
; deux lectures pour une valeur, etant 
; donn^ que nous ne changeons pas de 
; registre. 



LDX #$0000 
BOUCLE LDA $C03D 

BNE ADMIS 

LDA #$01 
ADMIS STAL MEMOIRE,X 
INX 
BEQ FINI 



DELAY 



FINI 



LDY #$20 

DEY 

BNE DELAY 

BRA BOUCLE 

RTS 



Debut du banc. 

Lecture d'une valeur venant d'etre 
convertie. 

Si c'est un $00, alors on ne I'admet 
pas 

et on le remplace par un $01. 
Stockage. 
Valeur suivante. 

Si on est arrive ^ 64 K de donnees, 
alors fin. 

Boucle de delai h regler selon la 
qualite de 
; numerisation que Ton veut obtenir. 

; Retour pour un nouveau cycle. 

; Fin de la routine. 



6.1.1.4 Le connecteur du DOC 

A titre indicatif, void les caracteristiques du connecteur 7 broches de 
type «Molex» qui se trouve place sur la carte m^re juste k droite du 
DOC et h gauche du connecteur d' extension memoire. La patte n 1 se 
trouve vers le voyant vert du GS. 
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Signal 


Patte 


Maximum 


Unite 


Entree du convertisseur A/D 
Impedance d'entree 


1 
3000 


2^ 
Ohms 


Volts «peak-to-peak» 


Masse analogique (GND) 


2 


- 


- 


Sortie analogique 
Charge de sortie 


3 


-5^+5 
10000 


Volts «peak-to-peak» 
Ohms (minimum) 


Adresse du canal 
Adresse du canal 1 
«Canal strobe» 
Adresse du canal 2 


4 
5 
6 
7 


1 
1 
1 
1 


Charge LS IIL 
Charge LS TIL 
Charge LS TIL 
Charge LS 1 IL 



«Canal strobe» est au niveau bas lorque I'adresse du canal est valide. 
Le fait que seulement trois des quatre canaux de sortie du DOC soient 
relies au connecteur ne permet que 8 combinaisons possibles. Done, 
bien qu'il soit possible de programmer les oscillateurs sur 16 canaux, 
vous ne pourrez reellement en entendre que jusqu'^ huit ! Mais de 
toute faqon, la plupart des personnes se contenteront de la stereo qui 
n'utilise que deux canaux. 

6.1.2 Creation des sons 

Vous voilk presque capable de commencer les premiers essais, si ce 
n'est un petit detail : vous ne poss^ez encore aucun son et il va falloir 
les creer. II existe differentes possibilites en mati^re de creation so- 
nore. Cependant, n'oubliez pas que vous ne disposez que de 64 K de 
Ram Son et que la valeur $00 est reservee pour indiquer si besoin la 
fin d'un son. Void done trois methodes pour constituer une biblioth^- 
que de sons : 

6.1.2.1 Sons numerises 

Le principe de la numerisation consiste k convertir en donnees 
numeriques des informations de type analogiques. Dans le cas du 
son, une source sonore (micro, radio, lecteur CD, etc..) est reliee au GS 
et les impulsions sonores sont transformees en valeurs. Bien entendu 
pour realiser ces convertions, il faut disposer du materiel necessaire 
et il vous faudra acheter une carte d'extension, de numerisation. 
Cependant la plupart des cartes stereo poss^dent egalement la 
numerisation et votre investissement se revelera vite rentable. De 
plus un logiciel de numerisation est normalement fourni avec ces 
cartes. 
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Les sons ainsi obtenus ont une origine reelle mais leurs qualites k la 
restitution dependent de plusieurs parann^tres : le materiel utilise 
bien sur, nnais aussi la frequence d'echantillonnage. L'echantillon- 
nage consiste k convertir en un certain temps un certain nombre de 
valeurs. Ainsi, si le son que vous souhaitez numeriser k une duree 
reelle de 3 secondes, vous pouvez choisir par exemple de prendre des 
echantillons toute les 40 micro secondes ou toutes les 80 micro 
secondes. Dans le premier cas, le son aura un meilleur rendu aue dans 
le deuxi^me cas, mais il sera egalement deux fois plus long en 
memoire ! Helas la numerisation est couteuse en place memoire, et les 
64 K de Ram Son peuvent parfois §tre un peu justes. 
La plupart du temps, les sons numeris^s sont joues en mode «One- 
shot» pour un seul oruit, ou en mode «Free-run» pour des repetitions. 
Mais, etant donne que la numerisation suppose i' achat de materiel, il 
me sera impossible de donner ici un exemple. 

6.1.2.2 Sons synthetises 

La synthase sonore est compl^tement differente par rapport k la 
numerisation : 

- Les sons crees n'ont pas d'origine reelle. 

- La taille des sons est tr^s courte. La plupart du temps 256 octets. 

Le principe de la synthase consiste lui k creer une forme d'onde qui 
representera une periode et qui sera jouee en mode «Free-run», c'est 
k dire en continu. Toute forme d'onde est imaginable, mais certaines 
formes sont plus harmonieuses que d'autres et seul I'ecoute finale 
pourra etre un crit^re de choix. 

Pour notre exemple, nous allons creer une onde de type sinusoidale 
k I'aide d'un petit programme en Basic : 

10 FOX X=0 TO 255 

20 Y=INT (128-127*SIN(X/40.6)) 

30 POKE 16384+X,Y 

40 NEXT X 

Ligne 10 : On veut creer une onde de 256 octets. 

Ligne 20 : II faut des valeurs enti^res. Le 128 est utilise car il 
correspond au milieu de I'axe des ordonnees, si Ton imagine un 
rep^re representant la courbe. La formule a ete ^tudiee pour ne pas 
fournir de valeur nuUe. Rappelez vous qu'un z^ro indiquerait la fin 
du son, or nous voulons jouer le son en continu. Rappelez vous 
egalement que le Basic Applesoft calcule en radians. 

Ligne 30 : L'onde sera stockee k partir de $4000 jusqu'^ $40FF. 
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Puis nous allons transferer I'onde en Ram Son aux adresses $0000- 
$OOFF.Ensuite, il f audra programmer les reeistres du DOC pour enfin 
pouvoir entendre quelque chose. Nous allons utiliser I'oscillateur 
n $00 pour notre exemple, avec une frequence de $65B et son volume 
au maximum. Mais avant de commencer la programmation, voici un 
petit tableau recapitulatif des valeurs exactes k mettre dans les 
registres : 



n 


Valeur 


$00 


$5B (partie basse de la frequence) 


$20 


$06 (partie haute de la frequence) 


$40 


$FF (volume maximum) 


$80 


$00 (I'onde sonore debute en $0000 de la Ram Son) 


$A0 


$00 (canal de sortie k droite ; pas d'interrutpion ; 
mode «Free-run» ; oscillateur en action) 


$C0 


$00 (I'onde occupe 256 octets) 



II est judicieux de programmer les dif f erents registres dans leur ordre, 
mais il faut absolument programmer le registre de contrdle en der- 
nier, car c'est lui qui enclenchera le son. Par contre, s'il n'etait pas 
declare en dernier, il y aurait certainement un probl^me, car le son 
serait joue avant que ses param^tres fussent inaiques. 

Voici la routine en assembleur, qui jouera cette onde apr^s I'avoir 
transfere en Ram Son : 



* Routine jouant un son de synthase 



XC 

xc 

ONDE = $4000 

ORG $1000 
CLC 
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; Directive d' assemblage 

/ 

; Adresse de I'onde. 
; Ou ailleurs... 
; Mode natif. 



XCE 



* Transfert en Ram Son de I'onde 
* 

REP $30 ; Registres XY sur 16 bits 

SEP $20 ; et A sur 8 bits. 

LDAL $E100CA ; On choisi d'acc^der k la 

AND #%00001111 ; Ram Son avec auto-incrementation 

ORA #%01100000 ; des pointeurs... 

STA $C03C 

STZ $C03E ; Mise k zero des 

STZ $C03F ; deux pointeurs. 

LDX #$0000 ; On veut lire depuis le debut du son. 
ENCORE LDA MEMOIRE,X ; Lecture d'une valeur (ici depuis 

; $4000). 

STA $C03D ; Transfert en Ram Son. A noter qu'en 

; meme temps les pointeurs sont augmen 
; tes d'une unite, done il est inutile de s'oc 
; cuper des pointeurs. 

INX ; Valeur suivante. 

CPX #$100 ; A t'on deja transf ere les 256 octets ? 

BCC ENCORE 



Programmation du DOC 

LDAL $E100CA ; Volume selon celui du beep. 

AND #$0F 

STA $C03C ; Acc^s aux registres du DOC. 

LDA #$00 ; Registre frequence (bas) de I'oscillateur 
; n $00. 

STA $C03E 

LDA #$5B 

STA $C03D 

LDA #$20 ; Registre frequence (haut). 

STA $C03E 

LDA #$06 

STA $C03D 

LDA #$40 ; Registre volume. 
STA $C03E 
LDA #$FF 
STA $C03D 
LDA #$80 ; Registre d'adresse en Ram Son. 
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STA $C03E 

LDA #$00 

STA $C03D 

LDA #$C0 ; Registre de taille du son. 

STA $C03E 

LDA #$00 

STA $C03D 

LDA #$A0 ; Registre de controle de I'oscillateur. 

STA $C03E ; Attention, il est toujours preferable d'ecrire le 

LDA #$00 ; registre de controle en dernier, car c'est lui 

STA $C03D ; qui va effectivement declencher le son. 

RTS ; Sortie. Le son est en train d'etre joue. 



6.1.2.3 Sons synthetises utilises comme des sons numerises 

Ce type de son est un compromis entre les sons numeriques et 
synthetiques. En effet, ils n'ont pas d'existance reelle tout comme les 
sons de synthase, mais ils sont utilisees de la meme fagon que les sons 
numerises. Les avantages sont d'une part la purete des sons (contrai- 
rement h la numerisation qui produit toujours quelques parasites), 
d'autre part le fait de n' avoir besoin d'aucun appareil relatif h la 
numerisation. Cependant le desa vantage est de ne pas pouvoir obte- 
nir les sons voulus et id encore il f audra f aire beaucoup d'essais pour 
trouver des sons plaisants. De plus comme la taille de ce type de sons 
est voisine de celle des sons numerises et qu'ils sont construits par 
calculs, un certain temps d'attente est necessaire. 

Pour notre exemple, nous allons creer un son de 16 K ($4000 octets) 
h I'aide d'un petit programme Basic. Attention, le programme prend 
environ six minutes pour tout calculer. 

10 FOR X=0 TO 16383 

20 Y=INT ((128+(121-(X/140))*SIN(.12*X))) 

30 POKE 8192+X,Y 

40 NEXT X 

Ligne 20 : La formule est prevue pour donner un son dont le 
volume diminuera dans le temps. Bien entendu vous etes libre de 
creer n'importe quel son k partir du moment ou il ne comporte pas de 
valeur nuUe. 

Ligne 30 : Le son est stocke de $2000 k $5FFF. 

Un petit «BSAVE SOUND,A$2000,L$4000» serait le bienvenu pour 
sauver le son sur un disque au format Prodos 8 afin de ne pas avoir k 
patienter six minutes k cnaque fois. 
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Une fois le son cree et sauve, tapez les commandes suivantes 



CALL -151 

0<3/0.FFFFZ 

3/0<0/2000.5FFFM 



(passage dans le moniteur) 

(mise k zero du banc $03) 

(transfert du son au debut du banc $03) 



Le programme exemple jouant un son numerise serait le meme que 
pour ce type de son. Ainsi nous voulons que I'oscillateur n $01 (pour 
changer) joue ce son une seule fois (mode «One-shot»), h frequence 
$130, volume $C0, et sur le canal de gauche. Void done le petit tableau 
recapitulatif : 



n° 


Valeur 


$01 


$30 (partie basse de la frequence) 


$21 


$01 (partie haute de la frequence) 


$41 


$C0 (volume maximum) 


$81 


$00 (le son debute en $0000 de la Ram Son) 


$A1 


$12 (canal de sortie k gauche ; pas d'interruption ; 
mode «One-shot» ; oscillateur en action) 


$C1 


$36 (I'onde occupe 16384 octets). Referez vous au 
tableau du paragraphe 6.1.1.3.6 traitant des registres 
de taille des sons, pour trouver la bonne valeur k mettre 



Puis vous pourrez executer le programme machine suivant : 



* Routine jouant un son numerise 

XC ; Directive d'assemblage 

XC ; 

MEMOIRE = $030000 ; Banc de stockage des sons. 

ORG $1000 ; Ou ailleurs... 

CLC ; Mode natif. 

XCE 
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* Ecriture en Ram Son de 64 K de donnees 



REP $30 ; Registres XY sur 16 bits 
SEP $20 ; et A sur 8 bits. 



LDAL$E100CA 
AND #%00001111 
ORA #%01 100000 
STA $C03C 



; On choisi d'acceder k la 

; Ram Son avec auto-incrementation 

; des pointeurs... 



STZ $C03E ; Mise ^ z6ro des 
STZ $C03F ; deux pointeurs. 
LDX #$0000 ; On veut lire depuis le debut du banc. 
ENCORE LDAL MEMOIRE,X ; Lecture d'une valeur du banc (ici le 

; banc $03). 

Transfert en Ram Son. A noter qu'en 

meme temps 

les pointeurs sont augmentes d'une uni 

te, done il est inutile de s'occuper des 

pointeurs. 

Valeur suivante. 

Jusqu'k ce que les 64 K soit transferes. 



STA $C03D 



INX 

BNE ENCORE 



Programmation du DOC 



STA $C03C 

LDA #$01 

STA $C03E 
LDA #$30 
STA $C03D 
LDA #$21 
STA $C03E 
LDA #$01 
STA $C03D 
LDA #$41 

LDA #$C0 
STA $C03D 
LDA #$81 
STA $C03E 
LDA #$00 
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LDAL $E1 OOC A ; Volume selon celui du beep. 
AND #$0F 

; Acc^s aux registres du DOC. 



; Registre frequence (bas) de I'oscillateur 
;n$01. 



; Registre frequence (haut). 



; Registre volume. 



; Registre d'adresse en Ram Son. 



STA $C03D 

LDA #$C1 ; Registre de taille du son. 

STA $C03E 

LDA #$36 

STA $C03D 

LDA #$A1 ; Registre de controle de I'oscillateur. 

STA $C03E ; Attention, il est toujours preferable d'ecrire le 

LDA #$12 ; registre de controle en dernier, car c'est lui 

STA $C03D ; qui va effectivement declencher le son. 

RTS ; Sortie. Le son est en train d'etre joue. 

Comme vous pouvez le constater la programmation d'un son est en 
elle meme extremement simple, h partir du moment ou Ton connait 
les bases de fonctionnement de I'Ensoniq DOC. 

6.1.3 Les 4 modes de fonctionnement des oscillateurs 

Comme nous avons pu le voir les oscillateurs du DOC peuvent 
fonctionner selon quatre modes, choisis en programmant les bits 1 et 
2 des registres de la serie $A0. Certains de ces modes n'utilisent qu'un 
seul oscillateur, d'autres doivent etre groupes par deux. Dans le cas 
ou ils sont groupes par deux, il s'agit toujours d'un oscillateur pair 
couple avec son voisin impair, par exemple le n $00 avec le n $01, le 
n $08 avec le n $09, le n $1E avec le n $1F, etc... 

6.1.3.1 Mode «One-shot» 

C'est le mode le plus simple, que nous avons dej^ employe. Principa- 

lement utilise pour des sons longs (de type son numerise), il suffit 

d'un seul oscillateur pour qu'il fonctionne. 

Le fait de programmer I'oscillateur avec le mode «One-shot» remet k 

zero son accumulateur, c'est k dire que lorsque Ton va mettre en route 

I'oscillateur, le son sera joue obligatoirement depuis le debut. L'os- 

cillateur jouera une seule fois le son puis s'arretera de lui meme k la 

fin du son. 

Dernier detail sur le mode «One-shot» : il permet de jouer sans 

probl^me un son finissant par des zeros. 

6.1.3.2 Mode «Free-run» 

Egalement utilise avec un seul oscillateur ce mode permet de jouer 
plusieurs fois le meme son. Pour les sons de synthases, generalement 
de courtes tallies (256 octets le plus souvent), c'est le mode par 
excellence. 

Cependant, pour rejouer plusieurs fois le meme son, il f aut obligatoi- 
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rement que celui-ci ait une taille exacte (256, 512, 1024, 2048, 4096, 
8192, 16384 ou 32768 octets) en ne contenant aucun z^ro. Si tel etait le 
cas, I'oscillateur s'arreterait de lui meme. 

Contrairement au mode «One-shot», le mode «Free-run» ne remet 
pas I'accumulateur de I'oscillateur h zero, ce qui signifie que si vous 
mterrompez un son en train d'etre joue en arretantl'oscillateur, puis 
que vous le remettiez en marche, le son reprendra la oil il en etait et 
non depuis le debut. 



6.1.3.3 Mode «Swap» 

Ce mode qui fonctionneobligatoirement avec une paire d'oscillateurs 
offre des possibilites interessantes. Le principe de fonctionnementest 
le sui vant : un oscillateur programme en mode «Swap» va jouer le son 
comme s'il etait en mode «One-shot», puis va s'arreter et mettre en 
action I'oscillateur voisin. Mais il y a differentes possibilites de 
programmer les oscillateurs pairs et impairs en combmaison avec le 
mode «Swap» : 



Oscillateurs 


Effets recherch^s 


Pair 


Impair 




Swap 
Swap 

One-shot 


Swap 
One-shot 

Swap 


Possibilite de jouer les 64 K de la Ram Son ou un son 
finissant par des zeros, en emulation du mode Free-run 

Possibilite de jouer les 64 K de la Ram Son en emulation 
du mode «One-shot» ou faire jouer deux fois seulement 
le meme son. 

Possibilite de faire jouer Toscillateur pair en mode 
emulation «Free-run». Pour cela il suffit de declarer 
I'osdllateur impair en mode «Swap» sans le mettre en 
marche ni programmer ses autres registres k part celui 
de controle. 



Les autres combinaisons qui seraient possibles avec le mode «Swap» 
et les modes «Free-run» et «Sync» ne donnent rien d'interessant. 

Exemple de deux oscillateurs programmes en mode «Swap» et «Swap» 
afin de jouer un son finissant par des zeros. Le son sera joue par les 
oscillateurs n $06 et n $07 en altemance, avec une frequence de $120 
en volume maximum et sur le canal droit. Effectuez d'abord les 
operations suivantes pour charger votre son : 
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BLOAD SOUND (chargement du son en $2000) 

CALL-151 (passage sous moniteur) 

3/4000<0/2000.5FFFM (transfert du son en $034000-$037FFF) 
0<3/7500.7FFFM (id on met une suite de zeros pour que 

notre son n'occupe plus que $^500 octets 

de long) 

Ainsi notre son k une taille reelle de 13568 octets. Cependant, d'apr^s 
la structure de la Ram Son, il faut declarer sa taille par exc^s, d'oCi une 
taille de $4000 octets et la valeur $36 k mettre dans les registres de la 
serie $C0. Void maintenant le tableau recapitulatif des valeurs h 
mettre dans les registres des oscillateurs n $06 et n $07 : 



n 



Valeur 



$06 
$07 
$26 
$27 
$46 
$47 
$86 
$87 
$A6 

$A7 

$C6 

$C7 



$20 (partie basse de la frequence de I'osdllateur pair) 

$20 (partie basse de la frequence de I'oscillateur impair) 

$01 (partie haute de la frequence de I'osdllateur pair) 

$01 (parite haute de la frequence de I'oscillateur impair) 

$FF (volume de I'osdllateur pair) 

$FF (volume de I'osdllateur impair) 

$40 (le son commence en $4000 de la Ram Son) 

$40 (de meme pour I'osdllateur impair) 

$06 (canal de sortie k droite ; pas d'lnterruption ; 

mode «Swap» ; oscillateur en action) 

$07 (canal de sortie k droite ; pas d' interruption ; 

mode «Swap» ; osdllateur k 1 arret) 

$36 (Notre son de 13568 octets de long est tout de meme 

declare $4000, d'ou la valeur $36 selon le tableau des 

failles). 

$36 (de meme pour I'osdllateur impair) 



Notez que I'osdllateur n $06 va etre le premier k se mettre en action, 
tandis que le numero $07 est au depart k 1' arret. Par la suite, le n $06 
passera k I'arret d^s qu'il rencontrera un $00 dans la Ram Son, 
enclenchant immediatement le n $07, et ainsi de suite... 
Void enfin le programme, avec la routine de transfert des sons, 
maintenant bien connue : 
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* Routine jouant un son finissant par des zeros (premiere methode) 

XC ; Directive d' assemblage 
XC 

MEMOIRE = $030000 ; Banc de stockage des sons. 

ORG $1000 ; Ou ailleurs... 

CLC ; Mode natif. 
XCE 



* Ecriture en Ram Son de 64 K de donnees 

* 

REP $30 ; Registres XY sur 16 bits 
SEP $20 ; et A sur 8 bits. 

LDAL $E100CA ; On choisi d'acc^der k la 

AND #%00001111 ; Ram Son avec auto-incrementation 

ORA #%01100000 ; des pointeurs... 

STA $C03C 

STZ $C03E ; Mise k zero des 
STZ $C03F ; deux pointeurs. 
LDX #$0000 ; On veut lire depuis le debut du banc. 
ENCORE LDAL MEMOIRE,X ; Lecture d'une valeur du banc (id le 

; banc $03). 

Transfert en Ram Son. A noter qu'en 

meme temps 

les pointeurs sont augmentes d'une uni 

te, done il est inutile de s'occuper des 

pointeurs. 

Valeur suivante. 

Jusqu'^ ce que les 64 K soit transferes. 



STA $C03D 



INX 

BNE ENCORE 
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Programmation du DCXZ 



LDAL $E100CA 
AND #$0F 
STA $C03C 



LDA #$06 
STA $C03E 
LDA #$20 
STA $C03D 
INC $C03E 
STA $C03D 

LDA #$26 
STA $C03E 
LDA #$01 
STA $C03D 
INC $C03E 
STA $C03D 
LDA #$46 
STA $C03E 
LDA #$FF 
STA $C03D 
INC $C03E 
STA $C03D 
LDA #$86 
STA $C03E 
LDA #$40 
STA $C03D 
INC $C03E 
STA $C03D 
LDA #$C6 
STA $C03E 
LDA #$36 
STA $C03D 
INC $C03E 
STA $C03D 
LDA #$A6 
STA $C03E 
LDA #$06 
STA $C03D 
INC $C03E 
LDA #$07 
STA $C03D 

RTS 



; Volume selon celui du beep. 
; Acc^s aux registres du EXDC. 



; Registre frequence (bas) de I'oscillateur n $06. 



; Registre de roscillateur n $07. 

; Notez que I'accuinulateur contient toujours 

;$20. 

; Registre frequence (haut). 



; Registre volume. 



; Registre d'adresse en Ram Son. 



: Registre de taille du son. 



; Registre de contrSle de I'oscillateur. 
; Attention, il est toujours preferable d'ecrire le 
; registre de controle en dernier, car c'est lui 
; qui va effectivement declencher le son. 

; Remarquez qu'au debut seul I'oscillateur pair 
; va etre en action. 

; Sortie. Le son est en train d'etre joue. 
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Cette technique pour jouer un son se terminant par des zeros est tout 
k fait valable, cependant elle h I'inconvenient de demander deux fois 
les memes valeurs pour les registres pair et impair. Ainsi cela peut etre 
genant si vous avez besoin d' inter venir en court de traitement du son, 
car vous devrez le faire pour I'oscillateur pair, mais aussi pour 
I'oscillateur impair. Voici done la seconde m^thode, utilisant deux 
oscillateurs programmes en mode «One-shot» et «Swap». Nous gar- 
derons le meme son et les memes param^tres. Le tableau des valeurs 
est le suivant : 



n 



Valeur 



$06 
$26 
$46 
$86 
$A6 

$A7 

$C6 



$20 (partie basse de la frequence de I'oscillateur pair) 

$01 (partie haute de la frequence de I'osdllateur pair) 

$FF (volume de I'oscillateur pair) 

$40 (le son commence en $4000 de la Ram Son) 

$02 (canal de sortie k droite ; pas d'interruption ; 

mode «One-shot» ; oscillateur en action) 

$07 (canal de sortie k droite ; pas d'interruption ; 

mode «Swap» ; oscillateur k 1 arret) 

$36 (Notre son de 13568 octets de long est tout de meme 

declare $4000, d'oCi la valeur $36 selon le tableau des 

tallies). 



Notez que seul le fait que I'oscillateur impair soit en mode «Swap» 
arrete est important. On se moque des autres param^tres de I'oscilla- 
teur impair. Voici maintenant la routine : 



* Routine jouant un son finissant par des zeros (seconde methode) 

XC ; Directive d'assemblage 

XC ; 

MEMOIRE = $030000 ; Banc de stockage des sons. 

ORG $1000 ; Ou ailleurs... 

CLC ; Mode natif. 
XCE 
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* Ecriture en Ram Son de 64 K de donnas 

* 

REP $30 ; Registres XY sur 16 bits 
SEP $20 ; et A sur 8 bits. 

LDAL $E100CA ; On choisi d'acceder h la 

AND #%00001111 ; Ram Son avec auto-incrementation 

ORA #%01 100000 ; des pointeurs... 

STA $C03C 

STZ $C03E ; Mise h zero des 
STZ $C03F ; deux pointeurs. 
LDX #$0000 ; On veut lire depuis le d^but du banc. 
ENCORE LDAL MEMOIRE,X ; Lecture d'une valeur du banc (ici le 

; banc $03). 
STA $C03D ; Transfert en Ram Son. A noter qu'en 

; meme temps 

; les pointeurs sont augment^s d'une uni 

; t6, done il est inutile de s'occuper des 

; pointeurs. 
INX ; Valeur suivante. 

BNE ENCORE ; Jusqu'^ ce que les 64 K soit transferes. 



Programmation du DOC 



LDAL $E100CA ; Volume selon celui du beep. 

AND #$0F 

STA $C03C ; Acc^s aux registres du DOC. 

LDA #$06 ; Registre frequence (bas) de I'oscillateur 

; n $06. 
STA $C03E 
LDA #$20 
STA $C03D 

LDA #$26 ; Registre frequence (haut). 
STA $C03E 
LDA #$01 
STA $C03D 

LDA #$46 ; Registre volume. 
STA $C03E 
LDA #$FF 
STA $C03D 

LDA #$86 ; Registre d'adresse en Ram Son. 
STA $C03E 
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LDA #$40 

STA $C03D 

LDA #$C6 ; Registre de taille du son. 

STA $C03E 

LDA #$36 

STA $C03D 

LDA #$A6 ; Registre de controle de roscillateur. 

STA $C03E ; Attention, il est toujours preferable d'ecrire le 

LDA #$02 ; registre de controle en dernier, car c'est lui 

STA $C03D ; qui va effectivement declencher le son. 

INC $C03E 

LDA #$07 ; Attention I'oscillateur impair doit absolument 

STA $C03D ; etre en mode «Swap» et a I'arret. 

RTS ; Sortie. Le son est en train d'etre joue. 



6.1.3.4 Mode «Sync» 

Le mode «Sync» utilise aussi une paire d'oscillateurs, et generale- 
ment seul I'oscillateur impair sera programme avec ce mode. L'effet 
provoque est la synchronisation de I'oscillateur impair sur le pair, en 
produisant un meilleur niveau sonore. II n'est pas besoin de program- 
mer les autres registres de I'oscillateur impair, seul son registre de 
controle doit etre en mode «Sync» et peut meme etre arrete. 
II faut avouer que ce mode n'est pas d'une grande utilite, bien qu'il 
soit possible d'obtenir certains eff ets selon la fagon de programmer les 
deux oscillateurs. Par exemple mettre les deux oscillateurs en mode 
«Sync», ou seulement le premier, ou encore choisir une frequence 
differente pour chacun d'eux... Les possibilites sont trop nombreuses 
pour donner un exemple, et il vous sera facile de les tester vous meme. 



6.1.4 Les interruptions sonores 

La facilite du traitement des interruptions du GS est telle qu'il serait 
dommage de s'en pri ver dans le cas du son. En eff et chaque oscillateur 
du DOC a la possibilite d'envoyer un signal d' interruption s'il a ete 
programme pour. Le signal est declenche d^s la fin du son. 
Si vous utilisez le syst^me normal de gestion des interruptions, le 
vecteur de connexion du son se trouve en $E1 002C et il vous suf fit d'y 
mettre un JMP long vers votre routine de traitement. Par la suite votre 
routine devra determiner, si necessaire, lequel des 32 oscillateurs a 
produit r interruption, en utilisant le registre $E0 du DOC (voir le 
paragraphe 6.1.1.3.7 pour I'utilisation de ce registre). Bien entendu, 
s'il n y a qu'un seul oscillateur programme pour produire des inter- 
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ruptions, il sera inutile de se servir du registre $E0. 



Notre exemple aura pour but de changer la couleur du bord d'^cran 
k chaque fois que le son sera jou^. 



BLOAD SOUND 

CALL-151 

3/0<0/2000.5FFFM 



(chargement du son en $2000) 

(passage sous moniteur) 

(transfert du son en $030000-$033FFF) 



Nous utiliserons I'oscillateur n $1F, programme pour jouer le son en 
continu sur la canal gauche, avec une frequence de $160, un volume 
de moitie et I'autorisation d'interruption. Void le tableau des valeurs: 



n 



Valeur 



$1F 
$3F 
$5F 
$9F 
$BF 

$DF 



$60 (partie basse de la frequence) 

$01 (partie haute de la frequence) 

$80 (volume de moitie) 

$00 (le son commence en $0000 de la Ram Son) 

$18 (canal de sortie k gauche ; interruptions autorisee ; 

mode «Free-run» ; oscillateur en action) 

$36 (Notre son occupe $4000 octets de long). 



* Routine jouant un son produisant des interruptions 



XC 

xc 



; Directive d' assemblage 

MEMOIRE = $030000 ; Banc de stockage des sons. 

ORG $1000 ; Ou ailleurs... 

CLC ; Mode natif. 

XCE 



* Ecriture en Ram Son de 64 K de donnees 

* 

REP $30 ; Registres XY sur 16 bits 
SEP $20 ; et A sur 8 bits. 



LDAL $E100CA ; On choisi d'acceder h la 

AND #%00001111 ; Ram Son avec auto-incrementation 
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ORA #%01100000 ; des pointeurs... 
STA $C03C 

STZ $C03E ; Mise k zero des 
STZ $C03F ; deux pointeurs. 
LDX #$0000 ; On veut lire depuis le debut du banc. 
ENCORE LDAL MEMOIRE,X ; Lecture d'une valeur du banc (ici le 

; banc $03). 
STA $C03D ; Transfert en Ram Son. A noter qu'en 

; meme temps 

; les pointeurs sont augment^s d'une uni 

; te, done il est inutile de s'occuper des 

; pointeurs. 
INX ; Valeur suivante. 

BNE ENCORE ; Jusqu'^ ce que les 64 K soit transferes. 



* Detournement du vecteur son 

* vers notre routine de traitement 



LDA #$5C ; Code du JMP long. 

STAL $E1002C ; $E1002C est le vecteur son. 

LDA #<INTER ; Partie basse de I'adresse de notre routine 

STAL $E1002D ; de traitement des interruptions sonores. 

LDA #>INTER; Partie haute de I'adresse. 

STAL $E1002E 

LDA #$00 ; Nous sommes dans le banc $00. 

STAL $E1002F 



Programmation du DOC 



LDAL $E100CA ; Volume selon celui du beep. 

AND #$0F 

STA $C03C ; Acc^s aux registres du DOC. 

LDA #$1F ; Registre frequence (bas) de I'oscillateur 

; n $06. 
STA $C03E 
LDA #$60 
STA $C03D 

LDA #$3F ; Registre frequence (haut). 
STA $C03E 
LDA #$01 
STA $C03D 
LDA #$5F ; Registre volume. 
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STA $C03E 
LDA #$80 
STA $C03D 

LDA #$9F ; Registre d'adresse en Ram Son. 
STA $C03E 
LDA #$00 
STA $C03D 

LDA #$DF ; Registre de taille du son. 
STA $C03E 
LDA #$36 
STA $C03D 

LDA #$BF ; Registre de contrdle de I'oscillateur. 
STA $C03E ; Attention, il est toujours preferable 
LDA #$1 8 ; d'ecrire le registre de controle en dernier, 
STA $C03D ; car c'est lui qui va effectivement declen 
; cher le son. 

RTS ; Sortie. Le son est en train d'etre jou^ et le 

; bord d'ecran change h chaque fin du son. 



Traiten^ent de 1' interruption 



INTER SEP $30 ; A et XY sur 8 bits. 

INC $C034 ; Change la couleur du bord d'ecran. 

CLC ; Fin de la 

RTL ; routine d' interruption. 



Cette routine, qui une fois lancee fonctionne automatiquement n'est 

au'un simple exemple, mais vous pouvez dej^ vous rendre compte 
es possibilites. Le fait de changer la couleur du bord d'ecran n est 
gu^re interessant, mais vous remarquerez qu'en changeant la fre- 
quence de I'oscillateur, vous changerez egalement la vitesse de varia- 
tion de la couleur. Effectivement, cette routine n'est autre qu'un 
tempo, qui nous sera par la suite tr^s utile pour la musique. 



6.1.5 La stereo 

Si en dehors de 1' extension memoire il n'y avait qu'une seule carte h. 
acheter, ce serait une carte ster^ ! En effet, le GS et ses capacites 
sonores le meritent bien et vous ne regretterez pas non plus d'y 
ajouter des enceintes. Ainsi une telle carte permet pour chaque 
oscillateur de choisir si le son sortira k droite ou a gauche. Du point de 
vue programmation, chaque oscillateur programme avec un canal 
pair jouera h droite, tandis qu'avec un canal impair ce sera h gauche. 
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Cependant il est preferable de choisir le canal zero pour la droite et le 
un pour la gauche. 

Outre la stereo cette extension offre d'autres a vantages. Dej^, le fait de 
connecter des enceintes sur la sortie de la carte et non sur la sortie du 
GS evite certains parasites, car le son ne transite plus que par 1' inter- 
face de I'Ensoniq. De part ce fait, le beep du controle G ne sera pas 
reproduit par les enceintes connectees k la carte stereo. Ceci est tr^s 
important car vous pourrez baisser le niveau du volume de beep pour 
ne pas etre gene, sans pour autant perdre le volume des sons du GS, 
etant donne que le reglage du volume general par le tableau de bord 
ne concerne que le haut-parleur interne et la prise «jack» du GS. 
La plupart des cartes stereo comporte egalement un syst^me de 
numensation, et vous auriez tord de vous en pri ver . De plus, certaines 
cartes poss^dent leur propre amplificateur reglable. 
Mais si vous desirez done acheter une carte sterto, prevoyez egale- 
ment I'achat d'enceintes, auto amplifiees de preference, h moins que 
vous ne souhaitiez brancher votre chaine HLFI via la carte. 

6.1.6 Effets speciaux et divers 

Cette par tie contient quelques exemples de ce que I'on peut f aire avec 
le GS et le son, mais elle n'est pas exhaustive. 

6.1.6.1 Echo simple 

Le but pour produire un echo est de faire jouer un son une premiere 
fois k volume elev6, puis une seconde fois moins fort. Mais tout 
I'intefet est de le faire de fa?on automatique, sans intervention d'un 
programme en cours de traitement. Pour cela, il suffit d'utiliser deux 
oscillateurs, le premier programme en mode «Swap» en action, 
volume maximum et le second en mode «One-Shot» arrete, volume 
plus f aible. Bien entendu, il f aut que la frequence des deux oscillateurs 
soit la meme, k moins que vous ne desiriez un autre effet. Vu la 
simplicite de la routine, il me parait inutile de vous la donner. 

6.1.6.2 Passage droite-gauche 

L'effet de passage d'un son d'un haut-parleur k I'autre pendant qu'il 
est en tram d'etre joue est assez interessant, mais il est necessaire 
qu'un programme intervienne en cours de traitement, et vous ne 
pourrez done rien faire d'autre pendant ce temps. 
Le principe consiste k utiliser deux oscillateurs programmes en mode 
«One-shot» aui joueront le son en meme temps, l^n sur la droite k 
volume eleve, I'autre sur la gauche k volume nul. Mais pendant que 
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le son sera joue, une routine dimminuera le volume du premier 
oscillateur tout en augmentant celui du second. L'effet procure une 
a^eable sensation, pour peu que les deux haut-parleurs soient bien 
disposes et k condition bien entendu de poss^der une carte ster^, 
sans laquelle il n'y aurait aucun effet. 

Pour notre exemple, nous allons charger notre son comme d' habi- 
tude, et nous le ferons jouer k frequence $120. 

BLOAD SOUND (chargement du son en $2000) 

CALL-151 (passage sous moniteur) 

3/0<0/2000.5FFFM (transfer! du son en $030000-$033FFF) 

Nous utiliserons les oscillateurs n $00 et n $01, Void le tableau des 
valeurs : 



n 



$00 
$01 
$20 
$21 
$40 
$41 
$80 
$81 
$A0 

$A1 

$C0 
$C1 



Valeur 



$20 (partie basse de la frequence de I'oscillateur pair) 

$20 (partie basse de la frequence de I'oscillateur impair) 

$01 (partie haute de la frequence de I'oscillateur pair) 

$01 (parite haute de la frequence de I'osdllateur impair) 

$FF (volume de I'oscillateur pair) 

$00 (volume de I'osdllateur impair) 

$00 (le son commence en $0000 de la Ram Son) 

$00 (de m§me pour I'osdllateur impair) 

$02 (canal de sortie k droite ; pas d'lnterruption ; 

mode «One-shot» ; oscillateur en action) 

$12 (canal de sortie k gauche ; pas d'lnterruption ; 

mode «C)ne-shot» ; oscillateur en action) 

$36 (Notre son occupe $4000 octets) 

$36 (de meme pour I'osdllateur impair) 



*_ 



* Routinue jouant un son de droite ci gauche 



*_ 



XC ; Directive d' assemblage 

XC ; 

MEMOIRE = $030000 ; Banc de stockage des sons. 

ORG $1000 ; Ou ailleurs... 



CLC ; Mode natif. 

XCE 
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* Ecriture en Ram Son de 64 K de donn^es 

» 

REP $30 ; Registres XY sur 16 bits 
SEP $20 ; et A sur 8 bits. 

LDAL $E1 OOCA ; On choisi d'acc^der h la 

AND #%00001111 ; Ran\ Son avec auto-incrementation 

ORA #%01100000 ; des pointeurs... 

STA $C03C 

STZ $C03E ; Mise k zero des 
STZ $C03F ; deux pointeurs. 
LDX #$0000 ; On veut lire depuis le debut du banc. 
ENCORE LDAL MEMOIRE,X ; Lecture d'une valeur du banc (ici le 

; banc $03). 
STA $C03D ; Transfert en Ram Son. A noter qu'en 

; meme temps 

; les pointeurs sont augmentes d'une uni 

; te, done il est inutile de s'occuper des 

; pointeurs. 
INX ; Valeur suivante. 

BNE ENCORE ; Jusqu'^ ce que les 64 K soit transferes. 



Programmation du DOC 



LDAL $E100CA ; Volume selon celui du beep. 

AND #$0F 

STA $C03C ; Acc^s aux registres du DOC. 

LDA #$00 ; Registre frequence (bas). 

STA $C03E 

LDA #$20 

STA $C03D 

INC $C03E 

STA $C03D 

LDA #$21 ; Registre frequence (haut). 

STA $C03E 

LDA #$01 

STA $C03D 

INC $C03E 

STA $C03D 

LDA #$40 ; Registre volume. 

STA $C03E 

LDA #$FF 
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STA $C03D 
INC $C03E 
LDA #$00 
STA $C03D 
LDA #$80 
STA $C03E 
LDA #$00 
STA $C03D 
INC $C03E 
STA $C03D 
LDA #$C0 
STA $C03E 
LDA #$36 
STA $C03D 
INC $C03E 
STA $C03D 
LDA #$A0 
STA $C03E 
LDA #$02 
STA $C03D 
INC $C03E 
LDA #$12 
STA $C03D 



; Registre d'adresse en Ram Son. 



; Registre de taille du son. 



; Registre de controle de I'oscillateur. 



; A partir d'ici, le son comnnence k etre 
; joue, mais au debut on ne I'entend qu'^ 
; droite. 



* Modification du volume 
* 



LDY #$FF 

BOUCLE LDA #$40 
STA $C03E 
LDA $C03D 
LDA $C03D 
DEC 

STA $C03D 
LDA #$41 
STA $C03E 
LDA $C03D 
LDA $C03D 
INC 

STA $C03D 
LDX #$FF 



; On va maintenant faire «glisser» le son 
; vers la gauche. Progressivement 255 fois. 
; Acc^s au volume de droite. 

; Deux lectures necessaires. 

; On diminue d'un. 

; Acc^s au volume de gauche. 

; Mais cette fois on augmente d'un. 

; Pour ne pas obtenir un changement trop 
; rapide. 



BOUCLE2 JSR ATTENTE ; il est necessaire d' avoir une routine de 

; timing. 
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DEX ; Timing qui dependra de la longeur du 

BNE BOUCLE2 ; son et de la valeur de la frequence. 

DEY 

BNE BOUCLE 

RTS ; Fin de routine. 

ATTENTE DS 18^EA ; Dans ce cas precis (longeur du son de 

; $4000 octets et frequence de $120), il faut 
; 18 NOP (dont le code est $EA). 
RTS ; Fin du sous-programme de timing. 

Notez que le reglage k pour fonction de bien r^partir I'ef fet de passage 
du volume de la droite vers la gauche, afin que le volume maximum 
arrive sur le haut-parleur de gauche exactement k la fin du son. 



6.1.6.3 Frequences decalees 

L'effet appele «Frequences decalees» peut etre parfois tr^s surpre- 
nant lorsque I'on ne s'y attend pas. Le principe consiste k faire jouer 
un meme son par plusieurs oscillateurs k la fois, mais pas avec la 
meme frequence. Par exemple, le premier oscillateur jouerait le son 
avec une frequence de $120, le deuxi^me avec $121, le troisi^me avec 
$122, etc... Le mode de fonctionnement de tous les oscillateurs serait 
soit le «One-shot», soit le «Free-run». Quoi qu'il en soit l'effet est 
spectaculaire car au debut les sons joues commencent en meme 
temps, mais tr6s vite ils se decalent les uns des autres. Plus vous 
utiliserez un nombre important d'oscillateurs, plus le resultat sera 
saisissant, mais veillez tout de meme k ne pas saturer les enceintes en 
baissant le volume des oscillateurs le cas echeant. 

6.1.6.4 Ensoniq et le hasard 

II arrive assez souvent que les programmeurs aient besoin de nom- 
bres aleatoires dans leurs applications, notamment s'il s'agit de jeux 
ou le hasard tient une place importante. II existe divers moyens 
d'obtenir des nombres tires au hasard, et je vais vous proposer ici une 
methode originale basee sur une utilisation d^toum^e des registres 
du DOC de la serie $60. 

En effet, ces registres qui contiennent la derni^re valeur lue par leur 
oscillateur correspondant (cf. paragraphe 6.1.1.3.3) n'ont pas d' utili- 
sation pratique pour le son. 

Mais imaginons maintenant qu'un oscillateur joue un son de 256 
octets en continu, k volume nul. II suffirait de lire son registre de 
donnee correspondant pour obtenir une des 256 valeurs contenues 
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dans I'onde de la Ram Son. II suffirait done de mettre des valeurs 
quelconques dans cette onde {h I'exclusion des zeros bien sur) et de 
Hre lorsque Ton en a besoin le registre de donnee pour obtenir un 
nombre aleatoire. Void les bases d'un exemple : 

- Progrannmer les 256 premiers octets de la Ram Son avec une suite 
de $01 et de $02. 

- Programmer I'oscillateur n $00 pour jouer les 256 premiers octets 
de la Ram Son en mode «Free-run», frequence $99 (choisir de prefe- 
rence une frequence impaire), volume $00 (car il n'y a aucun interet 
d'entendre ce son). 

- Quand vous aurez besoin d'une valeur tir^e au hasard (ici soit le 
$01, soit le $02), effectuer les instructions suivante : 

LDA #$60 ; Acc^s au registre de donnee. 
STA $C03E 

LDA $C03D ; Deux lectures necessaires. 
LDA $C03D ; L'accumulateur contiendra une valeur alea 
; toire. 

Les avantages d'une telle routine sont : la facility, le fait qu'elle soit 
automatique, la possibilite de configurer exactement les nombres que 
vous souhaitez. En effet, vous pouvez tr^s bien, dans notre exemple, 
mettre un plus fort pourcentage de $01 que de $02 afin de favoriser tel 
ou tel nombre. Et oui, vous pourrez vous meme configurer les proba- 
bilites ! 

Seule restriction : il est n^cessaire de lire le registre de donnee d'une 
faqon irreguli^re. Mais dans le cas d'un grand programme, il est rare 
d'avoir des cycles de temps reguliers. 



6.2 La Musique 

Si I'Ensoniq est capable de gerer automatiquement les sons, il n'en va 
pas de meme pour la musique. Ainsi vous devrez vous meme elaborer 
votre routine. L'ideal est de creer une routine de musique indepen- 
dante de votre programme, en utilisant les interruptions bien enten- 
du. Comme cefa il n'y aura pas de probl^me de aecalage temporel 
dependant de votre programme et, une fois lancee, la musique 
s'executera en prenant un minimum de temps machine. Mais de toute 
f agon, f aire de la musique sur GS n'est que I'aboutissement logique du 
son §t la pfogf ammation reste d'un niveau §imple. 

6.2.1 La methode des 64 K 

Si pour une raison ou une autre vous avez besoin de tout votre temps 
machine ou de toute la RAM du GS et que vous desiriez tout de meme 
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entendre une musique, voici une m^thode tr^s simple. II s'agit de 
numeriser 64 K de musique depuis un CD ou autre, puis de jouer les 
auelques secondes en continu de faqon k ce que Ton ait I'impression 
a'entendre un morceau sans fin. Bien entendu, vous aurez tout int^ret 
de choisir un passage bien rythm^ et sans parole. H^las, au bout de 
quelques instant d'Icoute, meme si le r^suftat est tout k fait accepta- 
ble, la musique n'en devient pas moins tr^s lassante. 
Done, si vous choisissez cette solution, il vous suf fira de programmer 
deux oscillateurs en mode «Swap», meme frequence pour les deux. Le 
premier oscillateur jouant les 32 premiers Kilos octets de la Ram Son, 
tandis que le second les 32 autres Kilos. 

6.2.2 Musique et interruptions 

Par contre, si vous cherchez une veritable solution pour jouer de la 
rnusique dans vos programmes, vous devrez utiliser les interrup- 
tions. II est certain qu'il existe plusieurs methodes possibles avec les 
interruptions, mais celle consistant h s'en servir comme tempo me 
parait la plus interessante du point de vue facilite et rapidite d' execu- 
tion. 

Ici, les sons representants les instruments seront stockes en Ram Son, 
et les notes avec leurs durees seront inscrites quelque part en RAM 
normale. Les notes devront ^tre converties en frequences selon une 
table donnee, tandis que les durees seront en fait des delais d'attente 
entre chaque changement de note. Helas il est tr^s difficile de trouver 
les veritables frequences correspondantes aux notes de la gamme, 
etant donne que les sons n'ont pas tous 6t6 num^ris^s h la meme 
frequence. 

Pour fonctionner, la routine devra interrompre le programme en 
cours tout les x temps et effectuer les divers changement de notes et 
de duree. Bien entendu, le programmeur devra veiller h ce que sa 
routine de musique soit la plus rapide possible afin de ne pas trop 
perturber le programme pnncipal. 

Voici done comme exemple une petite routine jouant une musique 
avec un seul son. La routine utilise alternativement I'oscillateur n $00 
et n $01 pour eviter d'entendre la mise en action et 1' arret des oscilla- 
teurs. 
Pour executer cette routine, il suffit de charger notre son : 

BLOAD SOUND (chargement du son en $2000) 

CALL-151 (passage sous moniteur) 

3/0<0/2000.5FFFM (transtot du son en $030000-$033FFF) 
Puis il suffit de lancer la routine en $1000. 
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* Routine de musique 

XC ; Directive d' assemblage. 

XC 

MEMOIRE = $030000 ; Banc contentant les sons. 
FREQBAS = $FE ; Deux octets de la page zero 

FREQHAUT = $FF ; utilises pour la sauvegarde des frequen 

; ces. 

ORG $1000 ; Ou ailleurs... 

CLC ; Mode natif. 

XCE 

* 

* Ecriture en Ram Son de 64 K de donnees 

* 

REP $30 ; Registres XY sur 16 bits 
SEP $20 ; et A sur 8 bits. 

LDAL $E100CA ; On choisi d'acc^der k la 

AND #%00001111 ; Ram Son avec auto-incrementation 

ORA #%01100000 ; des pointeurs... 

STA $C03C 



STA $C03D 



STZ $C03E ; Mise h zero des 
STZ $C03F ; deux pointeurs. 
LDX #$0000 ; On veut lire depuis le d^but du banc. 
ENCORE LDAL MEMOIRE,X ; Lecture d'une valeur du banc (ici le 

; banc $03). 

Transfert en Ram Son. A noter qu'en 

meme temps 

les pointeurs sont augmentes d'une uni 

te, done il est inutile de s'occuper des 

pointeurs. 

Valeur suivante. 

Jusqu'^ ce que les 64 K soit transferes. 



INX 

BNE ENCORE 



* Detournement du vecteur son 
» 



SEP $30 
LDA #$5C 



; $5C = opcode du JMP long. 
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STAL $E1002C ; Le vecteur d' interruption du son 

LDA #<INTER;setrouveen$E1002C. 

STAL $E1002D 

LDA #>INTER 

STAL $E1002E 

LDA #$00 

STAL $E1002F 



Mise en place du tempo 



LDAL $E100CA i 

AND #$0F ' 

STA $C03C ; Accfes aux registres du DOC. 

LDA #$1F ; On utilisera I'oscillateur n $1F i 

STA $C03E ; pour le tempo, avecune frequence de $100. ! 

LDA #$00 ; En augmentant la frequence, vous jouerez 
STA $C03D ; la musique plus rapidement. 
LDA #$3F 
STA $C03E 
LDA #$01 
STA $C03D 

LDA #$5F ; Le volume de cet oscillateur est k zero etant 
STA $C03E ; donne que nous ne voulons pas entendre le 
LDA #$00 ; son du tempo. 
STA $C03D 



LDA #$9F 

STA $C03E 

LDA #$00 ; Le «Son» joue commence en $0000 de la Ram 

STA $C03D ; Son et n'a qu'une duree de 256 octets. 

LDA #$BF 

STA $C03E 

LDA #$00 

STA $C03D 

LDA #$BF 

STA $C03E 

LDA #$08 ; Le mode utilise est le «Free-run» 

STA $C03D ; avec interruption. 



* Valeurs fixes pour les oscillateur n $00 et n $01 

* 

LDA #$40 ; Le volume des deux oscillateurs 
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STA $C03E 
LDA #$50 
STA $C03D 
INC $C03E 
STA $C03D 

LDA #$80 
STA $C03E 
LDA #$00 
STA $C03D 
INC $C03E 
STA $C03D 
LDA #$C0 
STA $C03E 
LDA #$36 
STA $C03D 
INC $C03E 
STA $C03D 



; sera h $50. 



; Le son utilise commencera en $0000 
; de la Ram Son. 



Le son aura une taille de $4000 octets. 



* Initialisation 



REP $30 ; A et XY sur 16 bits. 

STZ NUMERO; Remise k zero du compteur des notes 

STZ DELAI ; et du delai. 



RTS 



; Retour k I'appelant. A cet instant, la 
; musique est lanc6e et fonctionne auto 
; matiquement. 



Routine d' interruption 



INTER REP $30 



; A chaque interruption provoquee par 
; I'oscillateur n $1 F (tempo), le GS execut( 
; cette routine. 



LDA DELAI ; Si le delai est arrive k zero, alors c'est que 

BEQ LIBRE ; la note jou6e est terminee. 

DEC DELAI ; Sinon elle est en train d'etre jouee et on 



BRA FIN 



; decremente le delai, puis on sort. 



LIBRE LDX NUMERO ; X contient le numero (*2) de la note h 

; jouer. 
LDA MUSIQUE,X ; A contient la note et sa duree. 
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CMP #$FFFF 

BEQ RESET 

AND #$OOFF 

ASL 

TAY 

LDA NOTE,Y 

SEP $20 



Si A = $FFFF alors on est en fin de 

morceau 

et on se branche h RESET pour recom 

mencer. 

On ne garde que la note. 

Multiplication par 2 car les frec^uences 

sont cod^es sur deux octets. Puis trans 

fert dans Y. 

A contient maintenant la frequence sur 

16 bits. 

Mise de A sur 8 bits. Mais les 8 bits de 

poidfort de A restent cependant inchan 

ges. 
STA FREQBAS ; Sauvegarde dans une memoire de la 

; frequence (bas) 
XBA ; Les 8 bits de poids forts de A sont 6chan 

; g^s avec les 8 bits de poids faibles. 

STA FREQHAUT ; Sauvegarde de la frequence (haut). 

LDA #$A0 ; Acc^s au registre de mode de I'oscilla 
CLC ; teur n $00 ou n $01 en fonction de celui 

ADC UNCOUP ; qui est en train de jouer la note. 
STA $C03E 

LDA #$03 ; Mise k I'arret de cet oscillateur au cas ou 
STA $C03D ; il ne se serait pas encore arrete de lui 
; meme. 

LDA UNCOUP; Commutation de la variable UNCOUP 
EOR #$01 ; pour changer d'oscillateur. 

STA UNCOUP 

LDA #$00 ; Programmation de la frequence de I'os 
; cillateur 

CLC 

ADC UNCOUP 
STA $C03E 
LDA FREQBAS 
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RESET 
FIN 



STA $C03D 

LDA #$20 

CLC 

ADC UNCOUP 

STA $C03E 

LDA FREQHAUT 

STA $C03D 

LDA #$A0 

CLC 

ADC UNCOUP 

STA $C03E 

LDA #$02 

STA $C03D 

REP $30 

LDA MUSIQUE,X 



XBA 

AND #$00FF 
STA DELAI 

INX 
INX 

STXNUMERO 
BRA FIN 
LDX #$0000 

STX NUMERO 
CLC 

RTL 



;Mise en action de roscillateur avec 
; le mode "One-Shot", canal de droite 



Passage de A sur 8 bits 
Le registre X qui est toujours en 16 
bits contient encore la valeur du 
num^ro de la note. 
On commute A, pour acc^der h la 
, duree 

;et on ne garde que la dur^e. 
Stockage de la dur^e dans la varia 
ble DELAI 
Note suivante 

On sauve dans NUMERO 

Et c'est fini 

Mise h z6ro de la variable 

NUMERO 

CLC avant de sortir d'une routine 
, d'interruption 
; Fin de routine d'interruption. 



* Table et sauvegarde des donn^es 



NOTE HEX 60008000AOOOCOOO ;Table de convertion note 

; -> frequence 
HEX E000000120014001 ; les frequences sont cod6s sur 

; 16 bits 
NUMERO HEX 0000 ; 2 octets reserves pour stocker le num^ro 

; de la note. Les notes ^tant sur 2 octets, le 
; numiro est multiple par 2. 
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UNCOUP HEX 0000 ; la variable UNCOUP est utilisee pour 

; determiner si c'est roscillateurn $00 ou 
; n $01 qui doit etre utilise. 

MUSIQUE HEX 0110011002200330 ; Table contenant le numero de 

; musique 

HEX 0110052005200340 ; selon la structure suivante : un 
HEX 0610071006100510 ; octet pour la note, suivi d'un 
HEX 02200220FFFF ; octet pour la duree. Une paire 

; $FFFF signifie la fin du mor 

; ceau. 

Certes cet exemple ne joue de la musique que sur une seule voix, alors 
que le GS poss^de 32 oscillateurs. En tenant compte qu'il est prefera- 
ble de prendre deux oscillateurs par instrument et que I'oscillateur 
n $1F est utilise pour le tempo, cela nous fait 15 voix utilisables plus 
I'oscillateur n $1E de libre. 



Creation, mise en page, n\aquette. Impression 
ScMH4U^ CcM9i^, Forgest 



Imprime en France 
Depot legal, mars 1990 



^64^ copyright Tooftoj: 1990 



'"Le livre frangais 
qui vous fera comprendre le IIGS 



D.BAR 

D.DELAY 

Y.DURANT 

J.L.SCHMITT 

E.ricWEYLAND 



|t)ans ce livrede 464 pages, vous trouverez des informations 
ftechn^ques detaillees sur : 

- le 65C816, ses registres, ses instructions, ses modes d'adressage ... 
les drives 5,25" & 3,5", lecture, ecriture, deplacement du bras ... - 
f • le SmartPort ... 

• 1 'organisation de la memoire, les softswiches, le shadowing, 
I la BRAM ... 



le systeme d' exploitation GS/OS et Prodos, I'oi 

donneies sur disque ... 

le son, la Ram son, le GLU, le DOC, I'Ensoniq, la stereo... 



ISBN 2-9504508-0-6 

Mars 1990, Edite par Too/bo;f 
Depot legaU/90 

- Imprime en France 

Conception, mise en page, maquette, impression 
Saun>tJ*C<iiOHi, Forgest 



